必须禁用Nouveau驱动并重建initramfs，否则会导致黑屏或nvidia-smi不可用；安装前需通过kysec放行驱动、停止lightdm、注册DKMS，并验证lsmod与nvidia-smi输出。
如果您在麒麟操作系统（KylinOS）中安装NVIDIA显卡驱动时遇到黑屏、无法启动图形界面或nvidia-smi命令不可用等问题，则很可能是由于Nouveau驱动未禁用、内核模块冲突或安装环境不完整所致。以下是多种经验证的安装方法，适用于桌面版与服务器版KylinOS（含V10、V11及2503等主流版本）：
一、禁用Nouveau开源驱动并重建初始化内存盘
该步骤是所有安装流程的前提，用于防止系统默认的Nouveau驱动与NVIDIA官方驱动发生内核级冲突，确保后续安装可加载专有内核模块。
1、以管理员权限编辑黑名单配置文件：sudo vim /etc/modprobe.d/blacklist.conf
2、在文件末尾新增两行内容：blacklist nouveau 和 options nouveau modeset=0
3、保存退出后执行初始化内存盘重建：sudo update-initramfs -u（麒麟V10 SP3及以上部分版本需使用 dracut -f）
4、重启系统：sudo reboot
5、重启后验证禁用效果：lsmod | grep nouveau，若无任何输出即表示成功。
二、使用官方Runfile方式安装（兼容性最强）
该方法绕过包管理器直接编译安装，适用于所有KylinOS版本，尤其适合内核版本非标准或仓库无对应驱动包的场景。
1、切换至TTY文本终端：Ctrl+Alt+F1（部分机型为F2或F3）
2、登录后停止显示管理器：sudo systemctl stop lightdm（V11服务器版可能为gdm3或sddm，可先执行 systemctl list-units --type=service | grep -i display 确认）
3、进入驱动文件所在目录（如 /home/kylin/ 或 /data/），赋予执行权限：chmod a+x NVIDIA-Linux-x86_64-*.run
4、执行静默安装（推荐）：sudo ./NVIDIA-Linux-x86_64-*.run --silent --dkms --no-opengl-files --no-x-check --no-nouveau-check
5、若需交互式安装，直接运行：sudo ./NVIDIA-Linux-x86_64-*.run，在提示中选择：Yes 接受协议、No 跳过32位兼容库、Yes 注册DKMS（关键！否则内核更新后驱动失效）
三、通过APT/YUM包管理器安装（适用于仓库已集成驱动的版本）
该方式依赖系统源中预编译的驱动包，安装快捷且便于后续升级，但要求KylinOS版本与驱动版本严格匹配，仅限部分V10 SP3或V11高级服务器版支持。
1、更新软件源列表：sudo apt update（桌面版）或 sudo yum makecache（服务器版）
本地语音转文字，支持可选后端：Parakeet（精度最高）或 Whisper（速度最快，支持多语言）。
2、卸载残留驱动（如有）：sudo apt purge nvidia-dkms-closed nvidia-graphics-driver 或 sudo yum remove kmod-nvidia\*
3、安装编译依赖（必须）：sudo apt install build-essential linux-headers-$(uname -r) libc6-dev pkg-config libglvnd-dev
4、安装驱动包：sudo apt install nvidia-driver-550 nvidia-dkms（示例版本，实际以 apt search nvidia-driver 输出为准）
5、启用NVIDIA内核模块：sudo modprobe nvidia nvidia_modeset nvidia_uvm nvidia_drm
四、Kysec安全策略放行（银河麒麟特有步骤）
银河麒麟系统默认启用Kysec内核级安全机制，会拦截未经签名的驱动加载行为，必须显式放行安装程序执行权限，否则安装过程将被强制终止。
1、确认Kysec服务状态：sudo kysec_set -l
2、对驱动安装文件进行白名单注册：sudo kysec_set -n exectl -v kysoft NVIDIA-Linux-x86_64-*.run
3、临时关闭Kysec执行限制（安装期间）：sudo kysec_set -n setstatus -f kid off
4、安装完成后恢复安全策略：sudo kysec_set -n setstatus -f kid on
五、验证与故障排查
驱动安装完成后需立即验证模块加载状态与GPU识别结果，避免因X Server未正确加载而误判失败。
1、检查内核模块是否加载：lsmod | grep nvidia，应输出包含 nvidia、nvidia_modeset 等多行内容
2、查询GPU基本信息：nvidia-smi，正常应显示显卡型号、驱动版本、温度及GPU利用率表格
3、若出现“NVIDIA-SMI has failed because it couldn't communicate with the NVIDIA driver”错误：sudo dmesg | grep -i nvidia 查看内核日志，重点关注 nvidia: module license 'NVIDIA' taints kernel 之后是否有 Unknown symbol 或 invalid module format 提示
4、若图形界面无法启动，尝试重启LightDM：sudo systemctl start lightdm；仍无效则回退至TTY，检查 /var/log/Xorg.0.log 中关于 NVIDIA(0) 的EE（Error）级别日志
