Qt Creator安装时只装IDE，不自带编译器；需用在线安装器勾选Qt版本及配套编译器（如MinGW 11.2或MSVC 2019），再通过“工具→选项→构建和运行”配置编译器、Qt版本、调试器三者匹配的Kit。
Qt Creator 安装时不会直接让你“选择编译器”，它只装 IDE 本身；编译器必须单独安装、再手动配置。这是新手最容易卡住的第一步。
安装 Qt Creator 时根本没看到编译器选项？
这是因为：
-
Qt Creator是纯 IDE，不自带编译器（除 macOS 自带clang外） - Windows 上默认不附带
MinGW或MSVC，Linux 上不附带gcc，都需要你提前装好 - 官网在线安装器（如
qt-unified-windows-x64-online.exe）在组件选择页才提供勾选机会——但这一步不是“安装 Qt Creator”，而是“安装 Qt SDK 套件”
常见误区：
- 下载了
Qt Creator独立安装包（比如qt-creator-12.0.0-x86_64.exe），它真就只装 IDE，不带任何编译器 - 以为点下一步就能编译，结果新建项目后
Projects面板里显示 “No valid kits found”
正确做法：
- 优先用 Qt 在线安装器（Unified Installer），不是单下
Qt Creator - 安装过程中，在“Select Components”页务必勾选：
- 你想要的
Qt版本（如Qt 6.7.2） - 配套的编译器（如
MinGW 11.2或MSVC 2019） -
Qt Creator（通常默认勾选）
- 你想要的
- 这样装完，
Qt Creator启动后会自动检测到编译器和Qt版本，Kits一般能直接用
Windows 下 MinGW 和 MSVC 到底该选哪个？
关键看你要对接什么生态：
- 用
MinGW：适合跨平台开发、轻量部署、不想装 Visual Studio；但调试体验弱，部分 Windows API 调用受限（比如#include <windows.h>中某些函数可能不可用或行为异常） - 用
MSVC：适合已有 VS 工程迁移、需要完整 Windows API 支持、依赖 Visual Studio 生成的.lib或.dll；但必须匹配 VS 版本与 Qt 编译版本（例如 Qt 5.15.2 是用MSVC2019编译的，就不能配MSVC2022）
容易踩的坑：
- Qt 官方预编译版只支持特定 MSVC 版本，比如
Qt 5.14.0forMSVC2017，装了 VS2019 也用不了——得重装对应版本的 Qt，或自己源码编译 -
MinGW的g++路径必须指向bin/g++.exe，不是mingw32-g++.exe或x86_64-w64-mingw32-g++.exe（Qt Creator 识别不一致会导致 Kit 不可用）
配置完编译器，Kit 还是灰色不可用？
Kit（构建套件）依赖三个要素同时有效：
- 编译器（
Compilers页已添加且路径正确） - Qt 版本（
Qt Versions页指向对应qmake，路径不能错，比如C:\Qt\6.7.2\mingw_64\bin\qmake.exe） - 调试器（
Debuggers页，MinGW对应gdb，MSVC对应cdb；Qt Creator 通常自动填，但若手动删过就得补）
检查顺序：
- 打开
Tools → Options → Build & Run - 先看
Compilers页有没有绿色对勾（表示路径可执行） - 再看
Qt Versions页有没有识别出版本号（不是“Unknown”） - 最后看
Kits页，每行右侧的感叹号图标点开，能看到具体哪一项缺失或报错
真正麻烦的不是选编译器，而是让三者对齐。Kit 显示灰色，90% 是 qmake 路径错了，或者编译器 ABI（比如 x86_64-windows-msvc2019_64）和 Qt 版本的 ABI 不匹配——这个细节藏在 Kit 名称末尾，很多人忽略。
