UOS系统安装NVIDIA驱动提示“gcc not found”需先确认GCC是否缺失，再通过apt install build-essential在线安装或离线部署deb包补全；验证时需检查架构匹配、软链接有效性及开发者模式。
UOS系统安装NVIDIA显卡驱动时提示“gcc not found”，说明驱动编译模块在构建内核模块阶段缺失C语言编译器，此时安装程序无法生成nvidia.ko等关键驱动文件，直接导致安装中断或黑屏、无GPU加速、nvidia-smi命令报错。
确认GCC是否真的未安装
打开终端，执行：
gcc --version
若返回“command not found”，则确未安装；若显示版本号（如gcc version 11.3.0），说明GCC存在但驱动安装器未定位到——这通常因PATH路径异常或安装器调用的是特定gcc二进制名（如gcc-11）所致。此时需继续排查。
用APT快速安装完整编译环境
这是最稳妥的兜底方式，适用于绝大多数联网UOS桌面环境。
第一步：更新软件源索引 → 执行sudo apt update
第二步：安装build-essential元包 → 执行sudo apt install build-essential
该包自动拉取gcc、g++、make、libc6-dev、libgcc-11-dev等全部编译依赖，【不单独装gcc会导致后续nvidia-installer因找不到libc-dev而报错】。安装完成后无需重启，驱动安装器即可识别。
离线环境手动补全GCC及相关头文件
当目标机器完全断网，且无法使用apt update/apt install时，必须本地部署gcc及其运行时支撑组件。
方法一：从同版本UOS联网机导出全套deb包
在另一台架构一致（如均为loongarch64）、UOS版本相同（如V20 1070）的机器上执行：
mkdir -p ~/gcc-pkgs && cd ~/gcc-pkgs && apt-get download $(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances gcc | grep "^\w" | sort -u)
将整个~/gcc-pkgs目录拷贝至目标机，解压后执行：
sudo dpkg -i *.deb
若提示依赖错误，立刻运行：
sudo apt --fix-broken install
方法二：仅安装最小必要组件（节省空间）
必须按顺序安装以下三个包（缺一不可）：
libc6-dev_*.deb → libgcc-11-dev_*.deb → gcc_*.deb
顺序错误会导致dpkg报“unresolved dependency”并中止。
验证GCC是否被驱动安装器识别
执行NVIDIA官方.run包前，先运行：
sudo ./NVIDIA-Linux-x86_64-*.run --check
若输出中包含“gcc: found at /usr/bin/gcc (11.3.0)”即表示通过；若仍提示“gcc not found”，请检查：
① 是否为龙芯平台？需确认安装的是gcc-loongarch64-linux-gnu而非x86_64版；
② 是否修改过/usr/bin/gcc软链接？执行ls -l /usr/bin/gcc，确保指向真实可执行文件而非损坏链接；
③ 是否启用了开发者模式？部分UOS精简镜像需手动开启（设置→关于本机→点击版本号7次）才能解锁完整开发工具链权限。
