Qt Creator 14.0.2 启动后提示“No suitable kits found”

Question

Qt Creator 14.0.2 启动后提示 “No suitable kits found”，是新手及升级用户高频遇到的配置类问题。其根本原因在于：Creator 无法自动识别有效的 Qt 版本、编译器（如 MinGW 11/12、MSVC 2019/2022）及调试器三者组合——即“Kit”所需的三个核心组件未正确注册或版本不匹配。常见诱因包括：① 仅安装了 Qt Online Installer 中的源码或示例，未勾选实际 Qt 构建套件（如 `Qt 6.7.2 MinGW 11.2 64-bit`）；② 编译器（如 mingw11_64）已安装但未被 Creator 在 *Tools → Options → Kits → Compilers* 中扫描识别；③ Qt 版本路径含空格或中文字符导致解析失败；④ Qt Creator 14.0.2 对 Qt 6.7+ 新版元数据格式兼容性要求提高，旧版手动配置的 kit 可能失效。该问题不报错但阻断项目新建与构建，需逐项校验 Qt Versions、Compilers、Debuggers 的存在性与关联性。

Answer 1

```html

一、现象层：识别“No suitable kits found”的表征与影响范围

Qt Creator 14.0.2 启动后仅显示灰色提示框“No suitable kits found”，无堆栈、无错误日志、无弹窗警告——这是典型的“静默配置失败”。该提示并非运行时异常，而是启动阶段对 Kits 元数据的静态校验结果。对新手而言，它直接阻断 New Project → Choose Kit 流程；对升级用户（尤其是从 Qt 5.x 或 Creator 12.x 迁移者），常伴随原有项目无法打开或构建按钮置灰。值得注意的是：此提示不依赖具体项目，即使打开空工作区亦会触发。

二、结构层：Kit 的三维构成模型与耦合约束

一个有效 Kit 是三个独立但强耦合组件的笛卡尔积：

• Qt Version：必须为已编译的 qmake 或 cmake 可执行路径（如 C:\Qt\6.7.2\mingw_64\bin\qmake.exe），非源码/示例路径；
• Compiler：需与 Qt 版本 ABI 兼容（如 Qt 6.7.2 MinGW 11.2 64-bit 要求 g++.exe v11.2.x，且 gcc -v 输出中 Target 必须为 x86_64-w64-mingw32）；
• Debugger：GDB 或 CDB 路径必须可执行，且版本需匹配编译器输出格式（例如 MinGW 11+ 需 GDB 12+，否则因 DWARF5 支持缺失导致调试器注册失败）。

三者任意一项缺失、路径失效、ABI 不匹配或元数据签名不一致，均导致 Kit 自动剔除。

三、溯源层：四大高频诱因的技术验证清单

诱因编号	验证命令（Windows PowerShell）	预期输出特征	风险等级
① 缺失构建套件	Get-ChildItem "C:\Qt\6.7.2\" -Directory | ForEach-Object { $_.Name }	不含 mingw_64 或 msvc2019_64 等标准子目录	★★★★★
② 编译器未扫描	& "C:\Qt\Tools\mingw11_64\bin\g++.exe" --version	返回 g++ (MinGW-W64 x86_64-posix-seh, built by Brecht Sanders) 11.2.0	★★★★☆
③ 路径非法字符	Get-Item "C:\Program Files\Qt\6.7.2\mingw_64\bin\qmake.exe"	若报错 路径中具有非法字符，则含空格/中文	★★★☆☆
④ 元数据兼容性	cat "C:\Qt\6.7.2\mingw_64\lib\cmake\Qt6\Qt6Config.cmake" | Select-String "QT_VERSION_MAJOR"	Qt 6.7+ 引入 qt_add_executable() 语义，旧版 Creator 13.x 生成的 kit 描述文件（.user）可能含废弃字段	★★★★☆

四、诊断层：Creator 内置诊断工具链深度调用

进入 Help → About Plugins...，启用 QtSupport 和 ProjectExplorer 插件日志级别为 Debug；随后在 Tools → Options → Kits → Kits 页面点击右下角 “Rebuild Kit Information” 按钮——此操作将强制触发以下流程：

flowchart LR
A[Scan Qt Versions] --> B{Valid qmake?}
B -->|Yes| C[Parse qt.conf & CMakeLists.txt]
B -->|No| D[Skip & Log Warning]
C --> E[Match Compiler ABI Signature]
E -->|Match| F[Validate Debugger ABI]
E -->|Mismatch| G[Drop Kit - ABI Conflict]
F -->|Valid| H[Register Kit]
F -->|Invalid| I[Drop Kit - Debugger Mismatch]

五、修复层：分场景精准修复策略

1. 重装构建套件：运行 Qt Online Installer → 勾选 Qt 6.7.2 → MinGW 11.2 64-bit（勿仅勾选 Source 或 Examples）；
2. 手动注册编译器：在 Tools → Options → Kits → Compilers 中点击 Add → GCC → MinGW，路径设为 C:\Qt\Tools\mingw11_64\bin\g++.exe，名称设为 MinGW 11.2 64-bit；
3. 路径规范化：将 Qt 安装至 C:\Qt672\，通过符号链接映射（mklink /D "C:\Qt" "C:\Qt672"）兼顾兼容性与路径洁癖；
4. 元数据重建：删除 %USERPROFILE%\AppData\Roaming\QtProject\qtcreator\kit.xml 并重启 Creator，触发全自动重新发现逻辑（Creator 14.0.2 已优化 Qt 6.7+ 的 Qt6Config.cmake 解析器）。

六、防御层：企业级 Kit 管理最佳实践

面向 5 年以上从业者，建议建立跨团队 Kit 标准化体系：

• 使用 qmake -query 与 g++ -dumpmachine 输出生成 kit-spec.json 作为 CI/CD 构建基线；
• 在 Tools → Options → Kits → Kits 中启用 Auto-detect kits from Qt installations 并禁用 Auto-detect kits from compiler installations（避免误注册系统 GCC）；
• 为每个 Qt 版本维护独立的 qtcreator\profiles.xml 备份，包含完整 QtVersionId、CompilerId、DebuggerId 三元组哈希值，实现 Kit 版本可追溯。

```