NVIDIA 显卡

检查显卡型号

lspci | grep -i nvidia

驱动安装方式

方式一：使用 ubuntu-drivers（推荐）

sudo ubuntu-drivers devices
sudo ubuntu-drivers autoinstall

该命令会自动检测并安装最适合你显卡的驱动版本。

方式二：从 APT 手动安装

sudo apt update
# 以 ubuntu-drivers devices 输出的推荐版本为准，例如：
sudo apt install nvidia-driver-580

请先用 ubuntu-drivers devices 查看针对你的硬件推荐的版本，再把上面的版本号替换为推荐值。26.04 仓库当前提供 580（LTS 分支）到 590/595 等多个系列；不确定时优先选择标记为 recommended 的版本。查看仓库中可用的版本：

apt list nvidia-driver-*

方式三：从 NVIDIA 官网安装（不推荐）

从 NVIDIA 官网  下载 .run 文件安装。此方式可能与系统包管理冲突，不建议普通用户使用。

安装后验证

nvidia-smi

应显示驱动版本、GPU 型号及显存使用情况。

CUDA 安装

安装 CUDA Toolkit

Ubuntu 26.04 已将 NVIDIA CUDA Toolkit 纳入官方仓库：

sudo apt install cuda-toolkit

验证安装：

nvcc --version

安装特定版本 CUDA

如果需要特定版本（如用于深度学习框架），建议使用 NVIDIA 官方仓库：

wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2604/x86_64/cuda-keyring_1.1-1_all.deb
sudo dpkg -i cuda-keyring_1.1-1_all.deb
sudo apt update
sudo apt install cuda-toolkit-12-8

双显卡切换（PRIME）

笔记本电脑通常有集显 + 独显配置：

# 查看当前模式
prime-select query
 
# 切换到 NVIDIA 独显
sudo prime-select nvidia
 
# 切换到 Intel 集显（省电）
sudo prime-select intel
 
# 按需模式（推荐笔记本用户）
sudo prime-select on-demand

切换后需注销或重启。

常见问题

启动后黑屏

1. 在 GRUB 菜单按 e，在 linux 行末尾加上 nomodeset
2. 进入系统后卸载有问题的驱动：

sudo apt purge 'nvidia-*'
sudo apt autoremove
sudo reboot

3. 重新安装正确版本的驱动

Wayland 下 NVIDIA

Ubuntu 26.04 默认使用 Wayland。NVIDIA 驱动 535+ 已较好支持 Wayland。确认 GBM 后端已启用：

echo $XDG_SESSION_TYPE
# 应输出 wayland

26.04 的 Ubuntu Desktop 会话已是 Wayland-only，登录界面不再提供 “GNOME on Xorg” 选项。如遇 Wayland 下的兼容性问题，可安装提供 X.org 会话的其他桌面（如 kubuntu-desktop、xubuntu-desktop），并在登录界面选择对应的 X.org 会话，详见 Wayland 兼容性问题。

Secure Boot 与驱动签名

如果启用了 Secure Boot，安装驱动时会提示设置 MOK 密码。重启后在蓝色 MOK 管理界面中选择 “Enroll MOK” 并输入密码完成注册。

# 检查 Secure Boot 状态
mokutil --sb-state

驱动版本冲突

# 完全清除 NVIDIA 驱动
sudo apt purge 'nvidia-*' 'libnvidia-*'
sudo apt autoremove
sudo rm -f /etc/X11/xorg.conf
# 26.04 默认使用 Dracut 生成 initramfs：
sudo dracut -f
# 若系统仍在使用旧的 initramfs-tools，则改用：
# sudo update-initramfs -u
sudo reboot

相关文章

• NVIDIA / AMD 驱动（游戏） — 面向游戏场景的显卡驱动安装与性能调优
• 黑屏 / 卡启动 — NVIDIA 驱动安装后黑屏的排查与修复流程
• 笔记本休眠 — 独显笔记本的挂起、休眠问题与电源管理配置