统信UOS显卡驱动安装失败后黑屏或nvidia-smi报错，须先卸载nouveau模块、补全内核头与编译依赖、切换TTY停用lightdm并清空Xorg进程，再彻底purge或uninstall残留驱动，最后通过nvidia-smi、glxinfo和显示设置三重验证是否真正生效。
统信UOS显卡驱动安装失败后，图形界面卡死、黑屏、nvidia-smi报错或分辨率选项灰显，说明驱动模块未加载成功或与当前内核/显示服务冲突，必须按失效环节逐级回溯排查。
先确认是否被nouveau抢占GPU控制权
这是最常被忽略的致命前提——只要nouveau模块仍在运行，任何闭源驱动安装都会失败或触发Xorg崩溃。
打开终端，执行lsmod | grep nouveau，若有输出（哪怕只有一行），说明nouveau正在运行。
立即执行sudo modprobe -r nouveau卸载模块；若提示“module is in use”，则需先杀掉依赖进程：sudo pkill -f "Xorg\|lightdm\|gdm"，再重试卸载。
【必须在禁用nouveau后再重启系统，否则后续所有安装操作都无效】
检查内核头文件与编译环境是否完整
手动安装.run驱动或APT安装失败时，80%以上源于内核头缺失或build-essential未就位，导致nvidia.ko无法编译。
执行uname -r获取当前内核版本，例如返回5.10.0-amd64-desktop。
运行dpkg -l | grep "linux-headers-$(uname -r)"，若无输出，说明头文件未安装。
执行sudo apt install linux-headers-$(uname -r) build-essential dkms补全依赖——这一步不做，.run安装必然卡在“Building kernel modules…”并报错。
切换TTY并彻底停止显示服务
图形界面会独占GPU设备文件（/dev/nvidia*）并锁定内核模块加载通道，不退出就运行安装命令等于直接撞墙。
第一步：按Ctrl + Alt + F2切换至纯文本TTY终端。
第二步：登录后执行sudo systemctl stop lightdm（UOS默认）或sudo systemctl stop gdm3（若已切换为Gnome）。
第三步：验证服务状态：systemctl is-active lightdm必须返回inactive，否则继续执行stop命令。
第四步：强制清除残留X进程：sudo killall Xorg，再检查ps aux | grep Xorg应无任何输出。
回退已损坏驱动并清理残留
方法一：APT安装失败后残留配置极易引发下次安装冲突，必须彻底清除。
执行sudo apt purge nvidia-* && sudo apt autoremove --purge，该命令会删除所有nvidia相关包、配置文件及自动创建的xorg.conf片段。
方法二：若曾手动运行过.run安装器但中途失败，必须用其自带卸载工具清理。
进入.run文件所在目录，执行sudo ./NVIDIA-Linux-x86_64-*.run --uninstall，不要跳过此步直接重装，否则旧模块会与新模块争抢PCI BusID导致黑屏。
【执行purge或uninstall后，务必重启系统再进行下一次安装】
验证驱动是否真正生效
完成任一安装方式后，仅靠“安装完成”提示不能判定成功，必须通过三重验证。
第一重：运行nvidia-smi，能正常显示GPU型号、温度、进程列表即表示内核模块加载成功。
第二重：运行glxinfo | grep "OpenGL renderer"，输出中必须含NVIDIA字样，而非llvmpipe或swrast（后者代表仍走CPU软渲染）。
第三重：打开“显示设置”，原灰显的1920×1080@60Hz选项变为可选状态，且应用后屏幕不模糊、无撕裂——这才是驱动与桌面环境协同工作的最终证据。
