Ubuntu 安装 NVIDIA 显卡驱动（18.04 / 22.04）

原创已于 2025-09-03 14:28:18 修改 · 1.3k 阅读

14 ·

CC 4.0 BY-SA版权

文章标签：

#ubuntu #linux

于 2025-09-03 14:25:47 首次发布

Ubuntu 安装 NVIDIA 显卡驱动（18.04 / 22.04）

⚠️ BIOS 先关闭 Secure Boot，否则驱动模块无法加载。
以下流程已在 Ubuntu 18.04 与 22.04 实机验证通过。

一、前期准备

查看系统版本:lsb_release -a (或cat /etc/os-release)
查看显卡:lspci | grep -i nvidia

如果显示的是设备ID(例如10de:1b80 )，将ID复制到PCI devices查看显卡型号，便于官网选对驱动
下载 NVIDIA 驱动:
访问 NVIDIA 官网选择对应显卡型号，下载 .run 文件，如：NVIDIA-Linux-x86_64-535.261.03.run

驱动向下兼容，决定 可安装的最高 CUDA Toolkit 版本。
查看CUDA版本所需的最低驱动版本(官网查看更多)：

二、安装前清理

1.禁用 Nouveau 驱动

Nouveau 是 Ubuntu 默认开源驱动，可能与 NVIDIA 官方驱动冲突。不当操作会导致黑屏和登陆循环。

sudo tee /etc/modprobe.d/blacklist-nouveau.conf <<'EOF'
blacklist nouveau
options nouveau modeset=0
EOF

cat /etc/modprobe.d/blacklist-nouveau.conf #查看是否设置成功
sudo update-initramfs -u  #生效 
sudo reboot
lsmod | grep nouveau      # 无输出即成功

2. 卸载旧 NVIDIA（若从未安装可跳过）

安装方式	卸载命令
`.run` 安装	`sudo ./NVIDIA-*.run --uninstall`
`apt` 安装	`sudo apt purge nvidia* -y && sudo apt autoremove -y`

3. 安装正确版本的 gcc、g++

注意gcc版本，不同系統、驱动版本對gcc版本要求不同

Ubuntu 22.04安装软件仓库中自带的 GCC 11.x 版本

sudo apt update
sudo apt install build-essential 
#`build-essential` 是一个元包，内含 GCC、G++、Make 等常用构建工具。

#安装完成后验证版本
gcc --version
g++ --version
make --version

Ubuntu 22.04 安装 535.261.03 需要 gcc-12：

sudo apt update
sudo apt install gcc-12 g++-12
### 使用 `update-alternatives`设置为默认gcc版本：
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-12 60 \
  --slave /usr/bin/g++ g++ /usr/bin/g++-12
sudo update-alternatives --config gcc   

gcc --version #验证

三、切换到命令行模式

根据你的系统环境，执行以下对应命令：

桌面环境	关闭图形界面命令
GNOME	`sudo systemctl stop gdm3`
lightdm	`sudo service lightdm stop`

Ubuntu 22.04 使用GDM3
Ubuntu 18.04 使用lightdm
⚠️ 不确定桌面管理器？
cat /etc/X11/default-display-manager 查看输出 /usr/sbin/gdm3 或 /usr/sbin/lightdm。

ctrl+alt+f2 #进入命令行界面

四、正式安装驱动

cd ~/Downloads            # 驱动下载目录
sudo chmod +x NVIDIA-Linux-x86_64-535.261.03.run
sudo ./NVIDIA-Linux-x86_64-535.261.03.run \
  --no-opengl-files \
  --no-x-check \
  --no-nouveau-check

参数	作用
`--no-opengl-files`	防止与系统自带 OpenGL 冲突
`--no-x-check`	跳过 X 服务检查
`--no-nouveau-check`	跳过 nouveau 检查

安装完成后：

nvidia-smi        # 出现显卡信息即成功

在这里插入图片描述
若能看到显卡型号、驱动版本、CUDA 版本等信息，说明安装成功。

五、恢复图形界面并重启

sudo systemctl start gdm3   # 或 sudo service lightdm start
sudo reboot
nvidia-smi                  # 再次确认

六、常见错误排查

Unable to load the kernel module 'nvidia.ko'. This happens most frequently when this kernel module was built against the wrong or improperly configured kernel sources, with a version of gcc that differs from the one used to build the target kernel, or if another driver, such as nouveau, is present and prevents the NVIDIA kernel module from obtaining ownership of the NVIDIA GPU(s), or no NVIDIA GPU installed in this system is supported by this NVIDIA Linux graphics driver release.
```
解决思路:
		1.是否卸载干净
		2.排查是否nouveau干扰
		3.排查安装命令是否有-no-x-check
```
ERROR: An error occurred while performing the step: “Building kernel modules”. See /var/log/nvidia-installer.log for details.

1.排查是否是gcc版本导致的错误

vi /var/log/nvidia-installer.log-
搜索 gcc看是否因为 gcc 版本问题(:?gcc)
如下图显示则根据要求安装gcc

黑屏 / 登录循环 ：

解决思路:
1. 确认 `--no-opengl-files`
2. 检查 `/var/log/Xorg.0.log`

七、后续维护

禁止自动升级内核（避免驱动失效）

sudo apt-mark hold linux-image-$(uname -r) linux-headers-$(uname -r)

apt-mark hold执行后可以保持内核版本不变，除非解除 hold ；

sudo apt-mark unhold linux-image-$(uname -r) linux-headers-$(uname -r) #解除 hold 的方法
apt-mark showhold #查看被 hold 的包