qt creator未扫描到path里的gcc，需改用开发命令行启动（windows）或注释ld_library_path（linux/macos），并在options→compilers中手动添加gcc/g++完整路径，再于kits中绑定该编译器、qt版本及匹配调试器。
Qt Creator没扫描到PATH里的GCC，怎么办
Qt Creator启动时不继承终端的PATH环境变量，即使你在命令行里能直接运行gcc --version，它也可能完全看不到。这不是GCC没装好，而是Qt Creator运行时的环境上下文和你终端不一致。
- Windows用户：别双击桌面快捷方式启动Qt Creator；改用“x64 Native Tools Command Prompt for VS”或MinGW shell启动后再执行
qtcreator.exe - Linux/macOS用户：检查
~/.bashrc或~/.zshrc里有没有export LD_LIBRARY_PATH=...这类干扰项——Qt Creator自带库会被它覆盖，导致编译器扫描模块加载失败，建议临时注释掉再试 - 验证真实PATH：Help → About Plugins → Environment，看右侧显示的实际PATH是否包含GCC所在目录；如果没有，说明环境根本没生效
手动添加GCC编译器时路径填错的典型错误
填路径不是随便选个gcc就行，必须严格匹配C/C++编译器对，并指向可执行文件本身（不是目录）。
- C编译器填
/usr/bin/gcc，C++编译器必须填同一目录下的/usr/bin/g++；填成/usr/bin/clang++会报no C++ compiler - Windows上常见误填：
C:\mingw64\bin（目录）→ 正确应为C:\mingw64\bin\gcc.exe和C:\mingw64\bin\g++.exe - 路径含空格或中文（如
C:\Program Files\...）会导致Qt Creator解析失败，建议重装到D:\mingw64这类干净路径
Kit里编译器选了但还是Invalid
编译器加进列表只是第一步，Kit必须手动绑定它，Qt Creator不会自动关联。
- 打开Tools → Options → Kits，选中目标Kit（比如Desktop Qt 6.5.3 GCC 64-bit）
- Compiler下拉框必须明确选中你刚添加的GCC条目；如果显示
None或空白，就说明没绑上 - Qt version下拉框不能为空——点开后若无选项，去“Qt Versions”页手动添加
qmake路径（如/opt/Qt/6.5.3/gcc_64/bin/qmake） - Debugger必须匹配：GCC Kit配GDB，不能选CDB或LLDB（除非你明确装了兼容版）
CMake项目里GCC识别失败的隐藏条件
Qt Creator调用CMake时，不仅要看GCC路径，还会检查CMake自身能否用它编译测试程序。很多报错其实卡在这一步。
- CMake版本必须≥3.14；低于这个版本，Qt Creator会跳过GCC检测直接报错
- MSVC用户若混用GCC Kit，务必重启Qt Creator——否则CMake拿不到干净的环境变量，
The C++ compiler is not able to compile a simple test program就是典型表现 - CMake arguments里要显式指定
-DCMAKE_PREFIX_PATH=/path/to/Qt/6.5.3/gcc_64，路径必须精确到Qt编译套件根目录，少一级都不行
