必须安装适配硬件与内核的nvidia专有驱动，否则图形应用花屏、黑屏；需先执行lspci、uname -r、cat /etc/kylin-release确认显卡型号、内核版本、麒麟版本及cpu架构，并禁用nouveau驱动。
在麒麟系统上运行图形密集型应用、启用多屏显示或启动桌面环境时出现花屏、分辨率异常、GPU加速失效甚至黑屏，说明NVIDIA独立显卡驱动未正确加载，必须安装适配当前硬件与内核版本的专有驱动。
确认硬件与系统信息
这一步不能跳过，否则可能装错架构或内核版本导致驱动无法加载。打开终端依次执行：
运行 lspci | grep -i vga 查看显卡型号，重点确认输出中含“NVIDIA”及具体型号（如 GA106 [GeForce RTX 3060]）；
运行 uname -r 获取内核版本，例如 5.10.0-108-generic 或 4.19.90-2109.3.0.012.ky10.aarch64；
运行 cat /etc/kylin-release 确认麒麟OS版本（V10 SP3/V11/2503）和CPU架构（【x86_64 或 aarch64 必须严格匹配驱动包】）；
若 lspci 无任何显卡信息，检查独显是否插牢、BIOS是否禁用PCIe插槽，或主板是否默认屏蔽独立显卡输出。
禁用Nouveau并重建启动镜像
这是所有安装方式的强制前置步骤。Nouveau会抢占GPU控制权，不屏蔽会导致安装失败、黑屏或nvidia-smi不可用。
执行 sudo tee /etc/modprobe.d/blacklist-nouveau.conf → 按回车 → 输入 <code>blacklist nouveau → 按回车 → 输入 options nouveau modeset=0 → 按回车 → 输入 EOF；
执行 sudo update-initramfs -u（麒麟V10 SP3及以上部分版本需改用 sudo dracut -f）；
重启系统：sudo reboot；
重启后按 Ctrl+Alt+F1 进入TTY终端，运行 lsmod | grep nouveau —— 若无任何输出，说明禁用成功；若有输出，说明黑名单未生效，需检查文件路径是否为 /etc/modprobe.d/blacklist-nouveau.conf 及拼写是否准确。
APT一键安装（推荐初学者）
该方法利用麒麟官方源中预编译的驱动包，无需编译、自动适配内核、支持后续 apt upgrade 更新，适用于 GTX 10 系列至 RTX 30 系列主流显卡。
第一步：更新软件源并刷新缓存 → sudo apt update；
在OpenClaw上部署你的首席AI助理贾维斯（JARVIS）。针对Dell Pro Max GB10（NVIDIA DGX Spark）边缘设备优化。用于设置和配置贾维斯。
第二步：卸载残留旧驱动（如有）→ 执行 dpkg -l | grep nvidia 查看已安装包，若发现 nvidia-dkms-closed 或 nvidia-graphics-driver，则运行 sudo apt purge nvidia-dkms-closed nvidia-graphics-driver 彻底清除；【不清理旧包直接装新驱动会导致文件覆盖冲突，安装中途报错退出】；
第三步：安装闭源驱动 → sudo apt install nvidia-driver（自动选推荐版本），或指定版本如 sudo apt install nvidia-driver-535；
第四步：重启系统 → sudo reboot；
第五步：验证 → 启动后打开终端输入 nvidia-smi，正常应显示驱动版本、GPU 温度与显存使用率；若提示 command not found，说明 nvidia-utils 未随驱动一并安装，补执行 sudo apt install nvidia-utils-535 即可。
手动运行 NVIDIA .run 文件（适配 RTX 40 系列等新硬件）
当 APT 安装后 nvidia-smi 报 “No devices found”，或系统提示 “Your system has UEFI Secure Boot enabled”，说明需用官网最新 Runfile 驱动，并绕过包管理器直接部署。
方法一：禁用 Nouveau + TTY 下安装
先彻底禁用开源驱动：执行 echo "blacklist nouveau" | sudo tee /etc/modprobe.d/blacklist-nouveau.conf，再追加 echo "options nouveau modeset=0" | sudo tee -a /etc/modprobe.d/blacklist-nouveau.conf；
进入 TTY 终端（Ctrl+Alt+F1），登录后停止显示管理器：sudo systemctl stop lightdm（V11 服务器版可能为 gdm3 或 sddm，可用 systemctl list-units --type=service | grep -i display 确认）；
安装必要依赖：sudo apt install -y build-essential pkg-config libglvnd-dev linux-headers-$(uname -r)；
赋予驱动文件执行权限：sudo chmod +x NVIDIA-Linux-x86_64-*.run；
运行静默安装（推荐）：sudo ./NVIDIA-Linux-x86_64-*.run --silent --dkms --no-opengl-files --no-x-check --no-nouveau-check；
若需交互式安装，直接运行：sudo ./NVIDIA-Linux-x86_64-*.run，在提示中选择：Yes 接受协议、No 跳过 32 位兼容库、【Yes 注册 DKMS —— 关键！否则内核更新后驱动失效】。
