Ubuntu版本nvidia-smi提示版本不匹配问题，解决办法

老兵发新帖2026-02-05 10:08

您遇到的 NVML library version: 580.126 错误提示，结合我们之前的沟通，表明系统中的NVIDIA用户空间库版本与当前加载的内核模块版本不一致。这通常是由于驱动更新后没有完全生效或存在残留组件导致的。下面为您提供一个从诊断到解决的完整方案。

在采取行动前，我们先精确了解一下系统现状。请依次执行以下命令，这能帮助我们确认问题的具体表现。

bash 复制代码

# 1. 检查当前加载的内核模块版本
cat /proc/driver/nvidia/version

# 2. 查看系统已安装的NVIDIA驱动包版本
dpkg -l | grep nvidia-driver

# 3. 检查内核模块是否被加载
lsmod | grep nvidia

第一个命令的输出是当前正在使用的驱动版本 ，而第二个命令显示的是系统上已安装的软件包版本。版本不匹配正是问题的根源。

以下是每个步骤的详细说明：

进入终端模式（关键步骤）

为了避免图形界面相关进程的干扰，建议在操作前切换到纯文本模式。按 Ctrl + Alt + F3（或F2-F6中的任意一个功能键）登录一个TTY终端。如果需要返回图形界面，可按 Ctrl + Alt + F2。
彻底卸载现有驱动

执行以下命令来清除所有NVIDIA相关包，确保环境干净。
bash 复制代码
```
sudo apt purge '*nvidia*' '*cuda*' '*libnvidia*'
sudo apt autoremove --purge
```
安装匹配版本的驱动

安装与您的NVML库版本（580）完全匹配的驱动。
bash 复制代码
```
sudo apt update
sudo apt install nvidia-driver-580
```
安装过程中如果提示配置选项，通常保持默认设置即可。
重启系统并验证

驱动安装完成后，必须重启系统以加载新的内核模块。
bash 复制代码
```
sudo reboot
```
重启后，再次运行 nvidia-smi 检查是否正常输出。同时，可以再次使用 cat /proc/driver/nvidia/version 确认内核模块版本也已更新为 580.126.x 系列。

如果上述方法无效 ：可以考虑从NVIDIA官网下载对应版本的 .run 文件进行手动安装。此方法更复杂，但能避免包管理器可能带来的依赖问题。
预防措施 ：问题解决后，可以考虑使用以下命令锁定驱动版本，防止系统自动更新再次导致版本不匹配。
bash 复制代码
```
sudo apt-mark hold nvidia-driver-580
```