答案是PATH环境变量未包含GCC可执行文件路径，常见原因包括：①源码安装时指定了自定义prefix但未将对应bin目录加入PATH；②包管理器安装后Shell配置未重载；③误敲交叉编译器命令名如arm-linux-gnueabihf-gcc却输入gcc；④多版本共存时update-alternatives未配置默认链接；⑤精简系统缺少/usr/bin/gcc符号链接。
命令行里敲 gcc --version 报 “command not found”，基本就是 PATH 没配对，不是编译器坏了，是系统根本没找到它。
检查当前 PATH 是否包含 gcc 路径
直接运行 echo $PATH（Linux/macOS）或 echo %PATH%（Windows cmd），看输出里有没有 gcc 所在目录。常见正确路径包括：/usr/bin、/usr/local/bin、/mingw64/bin、C:\MinGW\bin、D:\x86_64-13.2.0-release-posix-seh-ucrt-rt_v11-rev1\mingw64\bin。如果没出现，说明环境变量漏了这一项。
注意：不同 Shell 加载的配置文件不同——bash 读 ~/.bashrc，zsh 读 ~/.zshrc，Windows 的 PowerShell 还要区分用户级和系统级环境变量。改完配置文件后，别忘了用 source ~/.bashrc 或重启终端生效。
验证 gcc 可执行文件是否真实存在
PATH 里写了路径，不代表里面真有 gcc。先 cd 进那个目录，再运行 ls -l gcc*（Linux/macOS）或 dir gcc*（Windows）。常见情况：
- 目录存在但没
gcc文件 → 工具链安装不完整，比如只下了 MinGW 但没装mingw32-gcc-g++包 - 有
gcc.exe但没gcc→ Windows 下某些包（如 MSYS2）默认提供的是gcc.exe，而 Go 的 cgo 会找gcc（无扩展名），此时需建软链接或改用gcc.exe显式指定 - 路径里有空格或中文 → Windows 下部分工具（如旧版 Go）会解析失败，必须换到纯英文无空格路径
IDE 或编辑器不认系统 PATH 怎么办
VS Code、GoLand、CLion 这类工具启动时可能不会继承你 shell 里设置的 PATH，尤其是从桌面图标启动时。典型现象是终端里 gcc --version 正常，但 IDE 内置终端或构建任务报 cgo: C compiler "gcc" not found。
解决方法：
- VS Code：关掉所有窗口，用命令行启动：
code --no-sandbox（确保继承当前 shell 环境） - GoLand：设置 → Go → 环境 → 把完整的
PATH值粘进去，不是只加一条路径 - CLion：Help → Edit Custom Properties → 添加
idea.env.reuse=true，强制复用系统环境
别信“重启 IDE 就行”——很多情况下它根本没读你刚改的 ~/.bashrc。
交叉编译工具链（如 ESP32）的 PATH 特殊性
xtensa-esp32-elf-gcc 这类交叉编译器，PATH 必须精确指向其 bin 目录，且不能混入其他 GCC 路径。否则 make 会优先调用主机上的 gcc，导致链接失败。
排查步骤：
- 运行
which xtensa-esp32-elf-gcc，确认返回路径是否属于~/.espressif/tools/xtensa-esp32-elf/下某个子目录 - 运行
xtensa-esp32-elf-gcc --version，验证该命令能执行 - 检查
PATH中~/.espressif/tools/xtensa-esp32-elf/...是否排在/usr/bin或C:\MinGW\bin前面——顺序错了就会用错编译器
最容易被忽略的一点：ESP-IDF 的 export.sh 脚本会动态修改 PATH，但只在当前 shell 生效；一旦新开终端或进 IDE，就得重新 source，或者把路径固化进 shell 配置文件。
