kit不可用是因为编译器、qt版本、调试器三者缺一或不匹配:缺组件则kit变灰或报“no valid kits found”,组件存在但绑定错误则显示黄色感叹号,常见原因包括sdk安装不全、路径含中文空格、abi不匹配、调试器格式不符、cmake版本过低或qmake路径无效。

Kit 不可用不是 Qt Creator 坏了,而是它找不到能一起干活的三个人:编译器、Qt 版本、调试器。缺一个,Kit 就变灰或带感叹号。
Kit 显示灰色或“No valid kits found”
这是最典型的“人没齐”状态——Qt Creator 启动后根本没扫描到任何可用组件。
- 先确认你装的到底是不是完整 Qt SDK:只装了
Qt Creator而没装Qt 6.9.0或Qt 5.15.2本体,Qt Versions列表必然为空;运行qmake -v报错就坐实这点 - 安装时漏选关键工具链:比如勾了
Qt Creator,却没勾同版本下的MinGW 11.2或MSVC 2022,那编译器那一栏永远是 “No compiler found” - 路径含中文或空格:哪怕
C:\Program Files\Qt\6.9.0\mingw_64\bin\qmake.exe真存在,Qt Creator 也可能跳过整个目录;建议重装到C:\Qt这类纯英文无空格路径
Kit 显示黄色感叹号(Unconfigured)
三个组件都存在,但绑定关系出问题。鼠标悬停看提示,大概率是 ABI 不匹配或调试器格式不对。
-
Qt Version和Compiler必须同源:用 MinGW 编译的 Qt 库(如Qt 6.9.0 (MinGW 11.2 64-bit))不能绑给 MSVC 编译器;反之亦然 - 调试器必须匹配编译器输出格式:MSVC 生成 PDB,得配
cdb.exe;MinGW 生成 DWARF,得配gdb.exe;混搭直接标黄 - CMake 版本太低:Qt 6.9 强制要求
cmake >= 3.25;若你系统 PATH 里只有cmake 3.22,Kit 会提示 “CMake configuration invalid”
手动添加 Qt Version 却提示 “invalid”
点 Manage → Add,选中 qmake.exe 后仍显示 invalid,说明头文件或 mkspecs 路径不对劲。
- 检查
qmake.exe同级目录是否存在mkspecs文件夹;没有就说明这不是官方 Qt 安装包,而是某个第三方精简版 - 运行
qmake -query,看输出里QT_INSTALL_HEADERS和QT_INSTALL_LIBS是否指向真实存在的路径;若为空或乱码,Kit 必 invalid - Linux 下常见陷阱:系统自带
/usr/bin/qmake指向系统 Qt5,但你项目需要 Qt6;必须手动指定/opt/Qt6.9.0/6.9.0/gcc_64/bin/qmake
最容易被忽略的是权限和杀毒软件——某些国产安全卫士会拦截 g++.exe 的进程创建,导致 Qt Creator 扫描时认为编译器“不可执行”。临时关闭实时防护再试一次,往往比折腾半天环境变量更有效。











