Kit不可用的直接原因是Qt Version、Compiler、Debugger三者缺一或不匹配,必须ABI对齐;常见表现为Kit列表全灰、“No suitable kits found”、新建项目弹红框,需依次检查Tools→Options→Build & Run中三者的注册状态与兼容性。

Kit 显示灰色或“No suitable kits found”直接原因
不是 Qt Creator 坏了,而是它根本没找到能用的构建三元组:一个 Qt Version + 一个匹配的 Compiler + 一个兼容的 Debugger。三者缺一不可,且必须 ABI 对齐(比如 MinGW-w64 11.2 编译的 Qt,不能配 MSVC 2022)。
常见表象包括:Kit 列表全灰、新建项目弹红框、鼠标悬停提示 “Compiler not set” 或 “Qt version not valid”。这时候别急着删重装,先看这三处是否都“在线”:
-
Tools → Options → Build & Run → Qt Versions:列表里有没有东西?点开看状态是不是 “Valid” -
Compilers标签页:有没有g++.exe(MinGW)或cl.exe(MSVC)被识别?路径是否真实存在? -
Debuggers标签页:对应编译器的调试器是否填了?GDB要配 MinGW,CDB要配 MSVC
Qt Version 显示 invalid 或为空
最常见原因是 qmake.exe 路径没被识别,哪怕它物理存在。Qt Creator 不会递归扫描整个磁盘,只认你手动加进去的路径,或自动扫描时能访问到的固定位置(如 C:\Qt\6.9.0\mingw_64\bin\qmake.exe)。
验证方式:打开命令行,运行 qmake -v。如果报“不是内部或外部命令”,说明没进 PATH;如果返回版本号但 Qt Creator 里仍为空,就是没注册。
Qt Creator 18.0.2 Windows x86_64 历史版本安装包,适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
- 手动添加:在
Qt Versions页面点Add,直接浏览到qmake.exe文件(不是文件夹) - 路径别含中文、空格或符号(如
C:\Program Files\Qt\...容易失败,建议用C:\Qt\6.9.0\mingw_64\bin\qmake.exe) - Qt 6.9+ 强依赖 CMake ≥ 3.25,如果
qmake有效但 Kit 仍 invalid,检查cmake --version输出是否达标
Compiler 被识别但 Kit 仍不可用
编译器出现在列表里 ≠ 能用。Qt Creator 会校验其输出格式、ABI 兼容性、甚至调用权限。尤其 Windows 下,杀毒软件拦截 g++.exe 读取或写临时文件是隐形杀手。
- 运行
where g++.exe(MinGW)或where cl.exe(MSVC),确认路径和Compilers页面里填的一致 - MinGW 路径含空格(如
C:\Program Files\mingw64\bin\g++.exe)大概率失败,重装到C:\mingw64\bin\更稳 - MSVC 用户必须确保已安装 “C++ build tools”,且
vcvarsall.bat可被调用;Qt Creator 启动前最好先运行一次"C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars64.bat" - 若用多个 Qt 版本(如 5.15 和 6.9),注意 Kit 绑定的是哪个——一个
Compiler可能同时匹配多个Qt Version,但只能选一个
Kit 配置完成却还是黄色感叹号
这时往往卡在 Debugger 这一环。它不像编译器能“凑合跑”,调试器必须和编译器生成的符号格式严格一致:MinGW 用 GDB,MSVC 必须用 CDB(Windows SDK 自带)或 LLDB(Clang 工具链)。
- MinGW 用户:下载
MinGW-w64完整包(带gdb.exe),路径填到Debuggers页面,别用 Dev-C++ 附带的残缺版 - MSVC 用户:检查
C:\Program Files\Windows Kits\10\Debuggers\x64\cdb.exe是否存在;若没有,通过 Visual Studio Installer 安装 “Windows 10/11 SDK” - Qt 6 默认启用 CMake 构建,Kit 里若显示 “CMake is not available”,不是 Kit 问题,而是系统
cmake没进PATH或版本太低(Qt 6.9 要求 ≥ 3.25)
Kit 的“可用”是动态校验结果,改完任一组件后必须点 Apply,再回到 Kits 页面看状态刷新——有时候界面不自动更新,需要手动切换标签页触发重载。

















