必须先安装兼容的NVIDIA驱动，否则CUDA安装会失败；需用lspci和nvidia-smi确认GPU及驱动状态，校验下载包SHA256值，停lightdm、切TTY、加--override参数运行.run安装器，仅装Toolkit并配置环境变量，最后用deviceQuery验证。
在统信UOS上安装CUDA开发包，必须先确保NVIDIA显卡驱动已正确安装且版本兼容，否则CUDA安装器会拒绝执行或后续编译失败；驱动版本过低会导致nvcc编译报错、设备不可见，甚至触发系统级崩溃。
确认GPU型号与驱动状态
打开终端，执行 lspci | grep -i nvidia 查看显卡型号；再运行 nvidia-smi，若显示驱动版本和GPU列表，则说明闭源驱动已就位。若提示“NVIDIA-SMI has failed”，说明nouveau未禁用或驱动未加载，此时不可继续CUDA安装。
执行 cat /proc/driver/nvidia/version 获取精确驱动版本号，用于比对CUDA官网的最低驱动要求表——例如CUDA 12.8要求驱动≥570.169，低于该值必须先升级驱动。
下载并校验CUDA安装包
访问 NVIDIA CUDA Toolkit Archive，选择与UOS内核匹配的Linux x86_64版本（推荐CUDA 12.4或12.8，避开12.5等存在UOS兼容性问题的版本）。
下载.run格式安装包（如 cuda_12.8.0_570.86.10_linux.run），用xftp传至UOS桌面目录；执行 sha256sum cuda_12.8.0_570.86.10_linux.run，比对官网公布的SHA256值，【校验失败则立即中止，不可强行安装】。
赋予执行权限：sudo chmod +x cuda_12.8.0_570.86.10_linux.run。
进入纯命令行环境安装
统信UOS默认运行LightDM图形界面，直接在桌面终端运行CUDA安装器会因X Server占用显存而失败。必须切换到无GUI环境：
第一步：执行 sudo systemctl stop lightdm 关闭显示管理器；
第二步：按 Ctrl+Alt+F3 切换至TTY3终端登录；
第三步：确认当前无X进程残留：ps aux | grep Xorg，若有输出需手动kill；
第四步：运行安装器：sudo ./cuda_12.8.0_570.86.10_linux.run --override，【务必添加--override参数，否则UOS会因检测到非Ubuntu/Debian标准环境而中止】。
安装过程中取消勾选“Install NVIDIA Accelerated Graphics Driver”，仅保留CUDA Toolkit和CUDA Samples（示例代码可验证安装结果）。
配置环境变量
安装完成后，CUDA默认路径为 /usr/local/cuda-12.8。编辑用户级配置文件：nano ~/.bashrc；
在文件末尾追加三行：
export PATH=/usr/local/cuda-12.8/bin:$PATH
export LD_LIBRARY_PATH=/usr/local/cuda-12.8/lib64:$LD_LIBRARY_PATH
export CUDA_HOME=/usr/local/cuda-12.8
保存后执行 source ~/.bashrc 立即生效；验证是否成功：nvcc --version 应输出CUDA编译器版本，which nvcc 应返回 /usr/local/cuda-12.8/bin/nvcc。
编译并运行CUDA示例
进入示例目录：cd /usr/local/cuda-12.8/samples/1_Utilities/deviceQuery；
执行 sudo make 编译；
运行 ./deviceQuery，若最后输出 Result = PASS，表示CUDA运行时环境正常；
若提示 no CUDA-capable device is detected，说明nvidia驱动模块未加载，需执行 sudo modprobe nvidia 并检查 dmesg | tail 是否有错误。
