先确认是否使用官方在线安装器、Qt与编译器ABI是否匹配、Qt Creator是否从终端启动以继承PATH，再检查vcvarsall.bat路径及Windows SDK版本一致性，最后验证调试器路径和清理编译器缓存。
Qt Creator 启动后“Kit 为空”或“编译器未找到”怎么快速定位？
这不是 Qt Creator 坏了，而是它根本没看到你系统里装的编译器。常见表现是 No valid kits found、Compiler not found，或者 Kits 页面里编译器列表空着、已配置的 Kit 显示红色感叹号。别急着重装，先确认三件事：
- 你安装的是 Qt 官方在线安装器（
qt-unified-windows-x64-online.exe），不是离线包 —— 离线包默认不含任何编译器组件 - 你装的 Qt 版本（比如
Qt 6.6.3）和你打算用的编译器（如MSVC 2019或MingW 11.2）必须 ABI 匹配；Qt 6.7.2 for Desktop MinGW 64-bit和MSVC 2022不能混用 - Qt Creator 启动方式影响环境变量：从开始菜单点开的 Qt Creator 不继承你终端里设置的
PATH，所以即使g++ --version在命令行能跑，它也看不见
手动添加 MSVC 编译器时 vcvarsall.bat 路径填错会怎样？
Qt Creator 添加 MSVC 编译器时，关键不是选 cl.exe，而是指定 vcvarsall.bat 的完整路径 —— 它才是初始化编译环境的入口。填错会导致 Kit 灰显、构建时报 MSVCP140.dll missing 或 link.exe not found。
- 正确路径示例：
C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvarsall.bat - 平台参数必须匹配：x64 对应
x64，ARM64 对应arm64；Windows SDK 版本（如10.0.19041.0）和 MSVC 工具集版本（如-vcvars_ver=14.34）要与 VS 安装一致，可在 VS Installer → 修改 → “单个组件”里查到 - 如果
vcvarsall.bat找不到，说明 VS 安装漏了“使用 C++ 的桌面开发”工作负载，不是只装了 IDE 就够了
为什么 Qt Creator 能看到 g++ 却配不出有效 Kit？
看见编译器 ≠ Kit 可用。Kit 是编译器 + Qt 版本 + 调试器 的三元组绑定，缺一不可。常见断裂点在调试器或 Qt 版本 ABI 不对。
- MinGW 用户最容易卡在调试器：Qt Creator 默认不自带
gdb.exe，得手动指向Qt\Tools\mingw11_64\bin\gdb.exe（路径随你装的 MinGW 版本变） - Qt 版本必须和编译器 ABI 严格对应：装了
mingw11_64，就得选Qt 6.x.x (MinGW 11.2 64-bit)，选成(MSVC 2019 64-bit)就直接灰显 - Windows 下调试器路径必须是绝对路径，且文件存在；
gdb.exe权限被杀毒软件拦截也会导致 Kit 黄色警告
Clang Code Model 报错 The clangbackend executable could not be started 怎么办？
这不是编译器问题，是 Qt Creator 的静态分析模块找不到 Clang 后端。Windows 版 Qt 默认不装 Clang 组件，哪怕你本地装了 LLVM 也没用 —— Qt Creator 只认自己安装目录下的 clangbackend.exe。
- 打开
MaintenanceTool.exe→ “添加或删除组件” → 展开 “Qt Creator” → 勾选 “Clang Code Model” - 组件路径通常是
Qt\Tools\QtCreator\lib\clang\，里面要有clangbackend.exe和配套的libclang.dll - Clang 不参与实际构建，只用于代码补全和错误高亮；如果只是想编译运行，不装它完全不影响
最常被忽略的点：Qt Creator 的编译器缓存不会自动刷新。改完 VS 安装或 PATH 后，必须重启 Qt Creator，甚至删掉 %LOCALAPPDATA%\QtProject\qtcreator\compilers.xml 让它重新扫描 —— 否则旧的“未找到”状态会一直残留。
