uos系统需手动解压安装显卡驱动以适配新硬件或内核不匹配场景，须禁用nouveau/radeon、停lightdm服务、执行.run或.tar.xz安装包并验证nvidia-smi等命令输出。
在UOS系统中手动解压安装显卡驱动，适用于官方仓库未收录、需适配特定硬件（如较新NVIDIA RTX 40系或AMD RX 7000系）或内核版本不匹配导致自动安装失败的场景，必须跳过uos-appstore和uos-driver-manager图形工具，直接操作驱动包文件。
确认驱动包类型与系统兼容性
访问显卡厂商官网（NVIDIA/AMD/Intel）下载对应UOS版本的.run或.tar.xz格式驱动包；【必须核对UOS内核版本（uname -r）与驱动包支持的kernel range一致，否则安装后无法加载模块】。例如：UOS V20 (23.10) 默认内核为6.1.0-amd64-desktop，若下载的NVIDIA驱动仅标注支持5.15–6.0，则不可用。
执行 ls -l *.run 或 ls -l *.tar.xz 确认当前目录下只有一个驱动文件，避免多版本混杂引发误操作。
禁用nouveau或radeon开源驱动（NVIDIA/AMD专用）
方法一：临时屏蔽（重启失效）
执行 sudo bash -c "echo 'blacklist nouveau' > /etc/modprobe.d/blacklist-nouveau.conf" → sudo bash -c "echo 'options nouveau modeset=0' >> /etc/modprobe.d/blacklist-nouveau.conf" → sudo update-initramfs -u。
方法二：永久生效（推荐）
编辑 /etc/default/grub，找到 GRUB_CMDLINE_LINUX 行，在引号内末尾添加 rd.driver.blacklist=nouveau modprobe.blacklist=nouveau，保存后执行 sudo update-grub → reboot。这一步不做，安装时会提示“nouveau正在运行”，且驱动模块无法插入。
切换到字符终端并停止显示服务
按 Ctrl + Alt + F2 进入TTY2终端，登录后执行 sudo systemctl stop lightdm（UOS默认显示管理器为lightdm；若已换为gdm3则停gdm3）。
确认图形界面已退出：运行 ps aux | grep -E "(Xorg|weston)" 应无活跃进程。未停止就强行安装会导致X服务崩溃、无法回退到桌面。
解压并运行驱动安装程序
第一步：赋予执行权限 → chmod +x NVIDIA-Linux-x86_64-535.129.03.run（以实际文件名为准）。
第二步：执行安装 → sudo ./NVIDIA-Linux-x86_64-535.129.03.run --no-opengl-files --no-x-check --disable-nouveau。
第三步：按提示选择「Yes」接受许可证 → 选择「No」跳过NVIDIA自带的32位兼容库安装（UOS桌面版默认不启用multilib）→ 选择「Yes」安装nvidia kernel module → 安装完成时勾选「Would you like to run the nvidia-xconfig utility?」选Yes，自动生成X配置文件。
注意：若驱动包是.tar.xz格式（常见于AMD或Intel开源驱动），则不用运行.run，而是解压后进入目录执行 sudo ./amdgpu-pro-install -y 或 sudo make && sudo make install（需提前安装build-essential和linux-headers-generic）。
验证驱动是否加载成功
重启系统后，执行 nvidia-smi（NVIDIA）或 clinfo | grep "Device Name"（AMD OpenCL）或 glxinfo | grep "OpenGL renderer"（通用）。
若输出中显示显卡型号及驱动版本，且无"Failed to initialize NVML"等错误，说明安装完成。
