kit显示“invalid”或“no compiler set”需手动配置:进入tools→options→kits,检查compiler下拉框是否为空,若为空则选择已注册编译器;若编译器未列出,需先在compilers页手动添加路径(如c:/qt/tools/mingw112_64/bin/g++.exe),并确保qt version和debugger正确绑定。

编译失败不是代码问题,而是 Qt Creator 没真正“认出”你的工具链。绝大多数情况,Kit 显示黄色警告图标或报 No compiler set in kit 就说明配置没生效,得从路径、环境、绑定三处动手。
Kit 显示 “Invalid” 或 “No compiler set” 怎么修?
这是最常见也最容易解决的卡点。Qt Creator 不会自动把系统 PATH 里的编译器塞进 Kit,必须手动关联。
- 打开 Tools → Options → Kits,选中对应 Kit(比如
Desktop Qt 6.5.3 MinGW 11.2 64-bit) - 检查
Compiler下拉框是否为空或显示None;若为空,点击右侧下拉箭头,选择已注册的编译器(如MinGW 11.2) - 确认
Qt version已选中且路径指向正确的qmake(例如C:/Qt/6.5.3/mingw_64/bin/qmake.exe) - 如果下拉列表里根本没有编译器,说明 Qt Creator 还没扫描到——跳到下一节处理
编译器在命令行能用,但 Qt Creator 找不到
你运行 g++ --version 或 mingw32-make --version 成功,不代表 Qt Creator 能访问到它们。它不继承终端的 PATH,尤其在 Windows 上启动方式不对时更明显。
Qt Creator 18.0.2 Windows x86_64 历史版本安装包,适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
- Windows 用户:不要双击桌面快捷方式启动 Qt Creator,改用
Developer Command Prompt for VS或MinGW shell启动,再执行qtcreator.exe - Linux/macOS 用户:检查是否在
~/.bashrc或~/.zshrc中设置了LD_LIBRARY_PATH—— 它会干扰 Qt Creator 自带库加载,导致崩溃或 Kit 失效,建议注释掉相关行 - 手动添加编译器:进入 Options → Compilers,点击
+,选择类型(GCC / MinGW / MSVC),然后填入完整路径,如C:/Qt/Tools/mingw112_64/bin/g++.exe
CMake 构建时报 “C++ compiler cannot compile a simple test program”
这个错误不是 CMake 本身坏了,是它调用编译器时失败了。CMake 需要干净的环境变量和明确的工具链描述。
- 检查 Kit 中是否启用了
CMake构建系统,并确认CMake executable指向的是你安装的 CMake(不是 Qt 自带那个旧版本) - MSVC 用户:务必通过 Visual Studio 的开发人员命令行启动 Qt Creator,否则
INCLUDE和LIB环境变量缺失,CMake 测试必然失败 - MinGW 用户:确保
mingw32-make.exe和g++.exe在同一目录下,且该目录已加入系统 PATH —— Qt Creator 的 CMake 配置页会读取 PATH 来定位make - Qt 6 + CMake 项目必须在
CMakeLists.txt开头显式声明cmake_minimum_required(VERSION 3.16),低版本 CMake 会拒绝解析 Qt6 的find_package(Qt6 REQUIRED COMPONENTS Core)
真正容易被忽略的是:Qt Creator 的 Kit 绑定只对当前打开的项目生效,切换项目或重装 Qt 后,Kit 可能自动回退到默认空配置;每次换环境后,别只看项目能否编译,先盯一眼左下角 Kit 名称旁有没有黄色感叹号。










