Qt Creator配合MinGW怎么搭建环境?

夏杰大大_5300

夏杰大大_5300

2026-08-08

365人浏览

原创

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

qt creator配合mingw怎么搭建环境?

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
Qt Creator 18.0.2

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,而不是你刚配的那个。务必手动点击切换。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
C++ Qt图形开发
C++ Qt图形开发

本专题专注于 C++ Qt框架在图形界面开发中的应用,系统讲解窗口设计、信号与槽机制、界面布局、事件处理、数据库连接与跨平台打包等核心技能,通过多个桌面应用项目实战,帮助学员快速掌握 Qt 框架并独立完成跨平台GUI软件的开发。

2025.08.15

4802

7

C++桌面程序开发
C++桌面程序开发

本专题聚焦 C++ 在桌面端图形界面应用开发中的实战应用,系统讲解 Qt 框架的信号与槽机制、界面布局管理、事件响应、数据交互、样式美化与多窗口应用设计等核心知识。通过实战案例(如记事本应用、数据管理工具、系统监控面板),帮助学习者掌握 从UI设计到完整桌面软件开发的C++工程化能力。

2025.10.23

1334

13

C++ 图形界面开发基础(Qt方向)
C++ 图形界面开发基础(Qt方向)

本专题系统讲解 使用 C++ 与 Qt 进行图形界面(GUI)开发的核心技能,内容涵盖 Qt 项目结构、窗口组件、信号与槽机制、事件处理、布局管理、资源管理,以及跨平台编译与打包流程。通过多个小型桌面应用实战案例,帮助学习者掌握从界面设计到功能实现的完整 GUI 开发能力。

2025.12.05

1421

15

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

2026.10.16

20

10

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

2026.10.16

0

10

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

2026.10.16

0

10

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

2026.10.16

0

15

Revel框架MVC路由与控制器
Revel框架MVC路由与控制器

本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

2026.10.16

0

15

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

2026.10.16

20

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Qt入门课堂 - Qt Quick Controls
Qt入门课堂 - Qt Quick Controls

共0课时 | 0人学习

Qt Creator 调试文档
Qt Creator 调试文档

共0课时 | 0人学习

Qt Creator 项目创建文档
Qt Creator 项目创建文档

共0课时 | 0人学习