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></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 名称末尾,很多人忽略。











