Qt Creator配置MinGW必须确保编译器、qmake版本、调试器ABI严格一致,缺一不可;手动验证路径(如g++.exe --version),按顺序添加编译器、Qt版本、Kit,并检查ABI匹配与sysroot设置,否则报“No valid kits found”或构建失败。

Qt Creator 配置 MinGW 不是“点几下就能跑”,而是必须确保三个组件一一对应:编译器路径、qmake 版本、调试器 ABI 一致。缺一不可,否则新建项目会报错 No valid kits found 或构建时卡在 Unknown module(s) in QT: core gui widgets。
怎么确认 MinGW 已安装且路径正确?
别信“自动检测”。Qt 安装包自带的 MinGW 通常放在 C:\Qt\Tools\mingw1120_64(版本号可能为 1120、1310 等),但路径里不能有中文、空格或符号。常见错误是解压到 C:\Program Files\ 或桌面,导致 g++.exe 找不到。
- 手动验证:打开命令行,执行
C:\Qt\Tools\mingw1120_64\bin\g++.exe --version,应输出类似g++ (MinGW-W64 x86_64-posix-seh, built by Brecht Sanders) 11.2.0 - 若提示“不是内部或外部命令”,说明路径错或环境变量没设——但
Qt Creator不依赖系统 PATH,它只认你填进设置里的绝对路径 - 注意区分
mingw32和mingw64:Qt 6 默认要求 64 位,选错会导致 kit 显示黄色警告“ABI mismatch”
编译器、Qt 版本、Kit 三者怎么配对?
这三步必须按顺序做,且每个环节的 ABI 必须严格一致(比如都是 x86_64-windows-msys-pe-64bit)。顺序错了,后面全白搭。
- 先加编译器:工具 → 选项 → 构建和运行 → 编译器 → 添加 → MinGW → 编译器路径填
C:\Qt\Tools\mingw1120_64\bin\g++.exe - 再加 Qt 版本:构建和运行 → Qt 版本 → 添加 → 选
C:\Qt\6.5.3\mingw_64\bin\qmake.exe(路径必须和你安装的 Qt 版本、架构完全匹配) - 最后配 Kit:构建和运行 → 构建套件 → 添加 → 名称随便写,编译器选刚加的那个,Qt 版本选刚加的那个,调试器选对应
gdb.exe(路径如C:\Qt\Tools\mingw1120_64\bin\gdb.exe)
如果 Kit 行末显示红色叉或黄色感叹号,鼠标悬停看提示——90% 是 ABI 不一致,比如 qmake 是 mingw64,但编译器填了 mingw32 的 g++.exe。
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
为什么调试器总报 “Unable to create a debugging engine”?
这不是 Qt Creator 坏了,而是 gdb.exe 和编译器不配套。Qt 官方打包的 mingw1120_64 自带 gdb.exe,但某些旧版 Qt(如 5.15)或手动下载的 MinGW 可能缺失或 ABI 错配。
- 检查
gdb.exe是否能运行:命令行执行C:\Qt\Tools\mingw1120_64\bin\gdb.exe --version,应输出GNU gdb (GDB) 11.2类似内容 - 如果报错“缺少 VCRUNTIME140.dll”之类,说明你用了 MSVC 编译的 gdb,必须换回 MinGW 自带的
- Qt Creator 12+ 对调试器校验更严:若
gdb的 ABI 和编译器不一致(比如一个是seh,一个是sjlj),它会直接禁用该调试器
创建项目时仍提示 “No valid kits found” 怎么办?
Kit 看起来已启用,但实际无效,最常被忽略的是 sysroot 和 Qt mkspec 路径隐式冲突。尤其当你混用在线安装器和离线包时。
- 打开 Kit 设置 → 点击你刚建的 kit → 展开“高级” → 检查
Qt mkspec是否为空;若为空,手动填win32-g++(Qt 5)或留空(Qt 6 默认识别) - Linux 下交叉编译 Windows 时,
sysroot必须填对,比如/usr/x86_64-w64-mingw32/sys-root;Windows 本地开发则不用填 - 重启 Qt Creator:配置变更后不重启,旧缓存可能导致 kit 状态未刷新
真正卡住的人,往往不是不会点按钮,而是没意识到 mingw1120_64、qt6.5.3_mingw64、gdb.exe 这三者必须出自同一套工具链发行包——混搭不同来源的组件,几乎必然失败。

















