答案是需手动在Tools→Options→Kits中绑定已添加的GCC编译器、Qt版本和匹配调试器。先确认gcc --version可用,再通过终端启动Qt Creator以继承PATH,接着在Compilers页添加gcc/g++完整路径,最后在Kits页手动为C/C++分别指定同一工具链编译器,并选对qmake和gdb。

Qt Creator 启动后找不到你刚装的 GCC,不是它坏了,而是它压根没扫描到——GCC 路径没进环境变量、或 Qt Creator 没在启动时读到,或者你填错了编译器类型和路径。
gcc --version 能跑,但 Qt Creator 里编译器列表为空
这说明系统层面 GCC 是可用的,但 Qt Creator 没继承这个环境。Windows 用户尤其容易中招:双击桌面快捷方式启动 Qt Creator,它运行在干净的系统会话里,根本看不到你手动加的 PATH。
- Windows:别用快捷方式,改用
cmd或 PowerShell,先执行set PATH=%PATH%;C:\your\gcc\bin(替换成你真实的 GCCbin目录),再运行qtcreator.exe - Linux/macOS:检查
~/.bashrc或~/.zshrc是否 export 了 PATH,然后用终端执行qtcreator启动(不是从图形界面点) - 验证 Qt Creator 实际看到的 PATH:Help → About Plugins → Environment 标签页,搜
PATH看有没有你的 GCC 路径
手动添加 GCC 编译器时填错路径或类型
Qt Creator 要求 C 和 C++ 编译器必须来自同一套工具链,且路径必须精确到可执行文件,不能只选目录。
- C 编译器填
/usr/bin/gcc(Linux/macOS)或C:\mingw64\bin\gcc.exe(Windows),C++ 编译器必须填对应的g++,不是clang++或clang - 别填
mingw32-g++.exe或x86_64-w64-mingw32-g++.exe—— Qt Creator 对前缀敏感,只认g++.exe - 如果用了自编译 GCC,确保
gcc和g++在同一目录下,且g++ --version输出显示它确实是 GCC 套件,不是链接到 Clang
Kit 里 Compiler 下拉框还是显示 None
就算编译器已添加成功,Qt Creator 也不会自动把它塞进 Kit。这是最常被忽略的一步。
- 打开 Tools → Options → Kits,选中你要用的 Kit(比如 Desktop Qt 6.5.3 GCC 64-bit)
- 在 Compiler 下拉框里手动选择你刚添加的 GCC 条目;注意:C 和 C++ 编译器要分别指定,且必须是同一个工具链的两个可执行文件
- Qt Version 下拉框不能空着——如果列表为空,去 Qt Versions 页面手动添加
qmake路径(如/opt/Qt/6.5.3/gcc_64/bin/qmake) - Debugger 必须匹配:GCC Kit 配
gdb,不能选cdb(那是 MSVC 的)
CMake 构建时报 “C++ compiler cannot compile a simple test program”
这个错误不是代码问题,是 CMake 在 Kit 环境下调用 GCC 失败。常见于路径正确但权限或环境缺失。
- 确认 Kit 的构建系统设为 CMake(不是 qmake),且 CMake executable 指向你本地安装的 CMake(不是 Qt 自带那个旧版)
- Windows 上若混用 MinGW 和 MSVC 工具链,CMake 会因 ABI 冲突直接失败;确保 Kit 中 Compiler、Qt Version、CMake arguments 三者 ABI 一致(都是 x64 + MinGW)
- CMake arguments 必须包含
-DCMAKE_PREFIX_PATH=/path/to/Qt/6.5.3/gcc_64,路径末尾不能漏掉gcc_64这个子目录 - 删掉项目下的
build目录和CMakeCache.txt,重新点击 Projects → Build → Run CMake 刷新配置
最容易被忽略的其实是 Kit 绑定动作本身——很多人以为“添加了编译器就等于能用了”,结果卡在灰色感叹号上半天。Qt Creator 不会自动关联,必须手动点下拉框选一次,而且 C/C++ 编译器得分别指定,缺一不可。


















