qt creator配合mingw需严格匹配版本与配置:①mingw版本须与qt预编译版本一致(如qt 5.15.2配mingw 8.1.0);②在“工具→选项→构建与运行”中手动指定编译器、qmake及调试器路径;③避免系统path干扰,推荐不设全局path;④新建项目时按构建方式选对模板(qmake或cmake),并手动确认右下角kit生效。

Qt Creator 配合 MingW 能直接跑起来,但“能编译”不等于“配置正确”——很多项目后期报错(比如链接失败、调试器断点无效、中文路径崩溃),根源都在初始 Kit 配置没对齐。
MinGW 版本必须和 Qt 库预编译版本严格匹配
Qt 官方为每个 Qt 版本预编译了对应 MinGW 工具链,混用就会出问题。例如:
-
Qt 4.8.7→ 必须用MinGW 4.8.2(文件名含mingw482) -
Qt 5.15.2→ 推荐MinGW 8.1.0(安装器里叫 “MinGW 8.1”) -
Qt 6.2.2→ 对应MinGW 11.2.0(注意不是系统 PATH 里的任意g++)
如果你从官网下载的是在线安装包(qt-unified-windows-x64-online.exe),安装时勾选的 MinGW 组件就是匹配好的;如果手动下载独立 MinGW(比如从 osdn.net),一定要核对版本号和 ABI(dwarf vs seh)、位数(i686 是 32 位,x86_64 是 64 位)是否与 Qt 版本一致。
Qt Creator 里要手动指定编译器和 qmake,不能只靠自动检测
Qt Creator 启动后常会“自动发现”工具,但容易误判——比如把系统 PATH 里的旧版 g++ 当成 Qt 配套编译器,或把 Qt 5 的 qmake 指给 Qt 6 项目用。
- 进
工具 → 选项 → 构建与运行 - 在
编译器标签页点击添加 → MinGW,路径指向Qt/Tools/mingwxx_xxx/bin/g++.exe(不是系统 PATH 里的) - 在
Qt 版本标签页点击添加,路径指向Qt/xx.x/mingwxx_xxx/bin/qmake.exe - 在
构建套件(Kit)标签页新建一个 Kit,编译器和Qt 版本必须都手动选中刚添加的项,调试器选对应gdb.exe(通常在同级bin/目录下)
配完后 Kit 行末尾不能有红色感叹号;如果有,鼠标悬停会提示缺哪个组件。
Qt Creator 18.0.2 Windows x86_64 历史版本安装包,适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
PATH 环境变量不是必须的,但一旦设了就得干净
很多人习惯把 MingW 或 Qt 的 bin 加进系统 PATH,结果导致命令行和 Qt Creator 行为不一致——比如终端里 g++ --version 显示 12.3,而 Qt Creator 用的却是 8.1。
- 推荐做法:不设全局 PATH,只让 Qt Creator 通过 Kit 显式指定路径
- 如果已设,务必确认
PATH中的mingw和qmake位置与 Kit 里填的一致 - 修改
PATH后,必须重启 Qt Creator(不是仅关闭项目)才能生效
尤其注意:Qt Creator 自带的 mingw32-make 和你系统 PATH 里的 make 不是同一个东西,别用错。
新建项目时选错模板会导致 Kit 不生效
创建项目时,如果选了 CMake 模板,Kit 里的 qmake 就完全不参与构建——此时实际起作用的是 CMakeLists.txt 和你配置的 CMake 工具链。
- 想用
qmake流程(默认 Qt 项目)→ 新建时选Qt Widgets Application或Qt Quick Application - 想用
CMake流程 → 在 Kit 设置里确认CMake生成器选的是MinGW Makefiles,且 CMake 可执行文件路径指向你安装的cmake.exe - 混合使用(如 CMake + Qt)时,
find_package(Qt6 REQUIRED COMPONENTS Widgets)必须和 Kit 中 Qt 版本一致,否则target_link_libraries会找不到库
最隐蔽的坑是:项目创建后,右下角状态栏显示的 Kit 名字可能和你预期不同——它默认选第一个可用 Kit,而不是你刚配的那个。务必手动点击切换。










