nvidia-smi报错或无输出，首要排查nouveau抢占或gpu未被识别；用lspci | grep -i nvidia确认硬件识别，空输出说明pci未发现设备，有输出但型号模糊需查nvidia官网反查；禁用nouveau须黑名单+update-initramfs+重启验证；安装方式依环境选.run（云/定制内核）、apt（ubuntu/debian稳版）或ubuntu-drivers autoinstall（自动选tested版）；nvidia-smi成功但程序无法用gpu，需检查cuda安装与版本匹配、容器工具链、桌面应用渲染设置及驱动模块加载顺序，强烈建议安装后重启。
nvidia-smi 命令报错或无输出，基本说明驱动没装好——别急着重装，先确认是不是 nouveau 在抢控制权，或者系统根本没识别到 GPU。
怎么确认显卡型号和是否被系统识别
终端里跑一句就能看到真实硬件情况，比查设备管理器还准：
lspci | grep -i nvidia
如果输出为空，说明 PCI 总线没发现 NVIDIA 设备，可能是物理没插稳、BIOS 关了独显、或者云服务器没透传 GPU。有输出但型号模糊（比如只显示 GA106），就去 NVIDIA 官网驱动查询页 输入设备 ID 反查具体型号。
常见误判点：
- 用
lshw -c display看到 “UNCLAIMED” 字样，大概率是 nouveau 还活着，没禁干净 - 在虚拟机里执行该命令，结果为空——绝大多数桌面虚拟机默认不透传 GPU，得开 IOMMU + VFIO，不是装驱动能解决的
- 云服务器上运行成功但
nvidia-smi失败，优先检查是否为“计算型实例”（如阿里云 gn7i、腾讯云 GN10X），部分入门级 GPU 实例只提供 vGPU 或无驱动支持
为什么禁用 nouveau 是绕不开的一步
nouveau 是内核自带的开源驱动，启动早、加载快，会抢先绑定 GPU 设备。NVIDIA 官方驱动模块（nvidia.ko）加载时发现设备已被占，直接退出，nvidia-smi 就会报 NVIDIA-SMI has failed because it couldn't communicate with the NVIDIA driver。
禁用它不是删文件，而是让内核“假装看不见”：
- 创建黑名单：
sudo tee /etc/modprobe.d/blacklist-nouveau.conf写入两行：blacklist nouveau和options nouveau modeset=0 -
sudo update-initramfs -u必须执行，否则重启后 initramfs 仍会加载 nouveau - 重启后验证：
lsmod | grep nouveau输出为空才算成功；若有输出，说明配置没进 initramfs 或文件路径/语法写错（比如多空格、少换行）
三种安装方式怎么选：.run、apt、ubuntu-drivers
选哪种不看教程推荐，看你的环境约束：
- 用
.run文件（如NVIDIA-Linux-x86_64-535.129.03.run）：适合云服务器、定制内核、或需要精确匹配 CUDA 版本的场景；但必须停图形界面（sudo systemctl stop gdm3或lightdm），且要提前装好gcc、make、linux-headers-$(uname -r) - 用
apt install nvidia-driver-535：Debian/Ubuntu 系最稳，驱动已适配当前内核，不用手动编译；但版本滞后，新卡（如 RTX 50 系列）可能不支持 - 用
ubuntu-drivers autoinstall：自动选“tested”标记的版本，省去查兼容表的功夫；但某些小众发行版（如 Deepin、Linux Mint 某些衍生版）该命令不可用，得换回apt search nvidia-driver手动挑
注意：apt remove --purge nvidia* 不会删掉 /usr/bin/nvidia-* 这类二进制，残留可能干扰新驱动加载；真要清场，加 sudo nvidia-uninstall（仅限 .run 安装过的情况）。
nvidia-smi 成功但程序用不了 GPU 的原因
nvidia-smi 能跑只代表驱动模块加载成功，不代表用户态库或 CUDA 环境就绪：
- PyTorch/TensorFlow 报 “CUDA not available”，先跑
nvidia-smi和nvcc -V——后者失败说明 CUDA 没装，前者成功后者失败，就是 CUDA 版本和驱动不匹配（查 CUDA 兼容表） - 容器里跑不通，大概率没装
nvidia-container-toolkit，或docker run没加--gpus all - 桌面应用（如 Blender）选不到 GPU 渲染，检查设置里是否勾选了
Cycles Render Device: CUDA，而不是 OptiX 或 HIP
最常被忽略的一点：驱动装完必须重启，或者至少 sudo modprobe -r nvidia_uvm nvidia_drm nvidia_modeset nvidia 再 sudo modprobe nvidia ——但很多依赖模块（如 nvidia-uvm）加载顺序错也会导致功能残缺，重启仍是最低风险操作。
