Qt Creator 正常工作的关键是将 qmake、编译器、调试器三者正确绑定到同一构建套件（Kit）；需手动指定 Qt 5 的 qmake 路径并验证版本，MinGW 因自带 gdb 而更省心；Kit 配置错位会导致构建失败或断点失效，修复时应新建 Kit 并明确指定各组件，且更换环境后须清除旧构建目录。

Qt Creator 配合 Qt 5 能正常工作，关键不是“装完就跑”，而是确保 qmake、编译器、调试器三者能被正确识别并绑定到同一个构建套件（Kit）里。很多卡在“项目无法构建”或“断点不生效”的问题，根源都在 Kit 配置错位。

怎么确认 Qt 5 的 qmake 路径是否有效

Qt Creator 不会自动猜对你的 Qt 5 安装位置，尤其当你手动解压或从 archive 下载时。必须手动指定 qmake 路径，否则新建项目默认用系统 PATH 里的第一个（可能是 Qt 6 或旧版）。

• 打开 工具 → 选项 → 构建与运行 → Qt 版本，点击右下角“添加”，浏览到类似 C:\Qt\5.15.2\mingw86_64\bin\qmake.exe 的路径（Windows）或 /Users/xxx/Qt/5.15.2/clang_64/bin/qmake（macOS）
• 选中该条目后，右侧会显示识别出的 Qt 版本号和模块列表；若显示“Unknown”或为空，说明路径错误或 qmake 权限/依赖缺失
• 终端里执行 qmake --version 应返回类似 QMake version 3.1 Using Qt version 5.15.2，否则 Qt 5 安装不完整

为什么 MinGW 是 Windows 下最省心的编译器选择

Qt 5 官方预编译包默认只提供 MinGW 和 MSVC 两种工具链。MinGW 在 Qt Creator 中兼容性更好，尤其对新手——它自带调试器 gdb，无需额外安装 WDK 或 Visual Studio 调试组件。

Qt Creator 18.0.2

Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。

下载

• 安装 Qt 5 时务必勾选对应 MinGW 版本（如 MinGW 8.1 64-bit），不要只装 Qt Creator 主体
• 在 构建与运行 → 编译器 页面，应能看到自动识别的 MinGW x.x.x 64-bit；若没有，手动添加，路径指向 mingw81_64\bin\g++.exe
• MSVC 虽快，但要求 Visual Studio 完整安装 + 正确的调试器（cdb.exe）路径配置，稍有偏差就报 Unable to create a debugging engine

Kit 配置失败的典型症状和修复动作

Kit 是 Qt Creator 的核心调度单元，它把编译器、调试器、Qt 版本、设备类型打包绑定。一个 Kit 出错，整个项目就构建失败或调试失灵。

• 现象：项目属性里显示 Qt 版本是 5.15.2，但构建时报错 Project ERROR: Unknown module(s) in QT: widgets → 实际调用的是 Qt 6 的 qmake，Kit 绑定错乱
• 现象：断点灰色不可用，控制台无调试输出 → Kit 中调试器未指定，或指定的 gdb 版本与 MinGW 不匹配（例如用 MinGW 8.1 却配了 gdb 8.0）
• 修复：进入 构建与运行 → Kits，新建一个 Kit，名称写清楚（如 Desktop Qt 5.15.2 MinGW 64-bit），然后依次指定已识别的编译器、调试器、Qt 版本；别用“自动检测”生成的默认 Kit，它常混用版本

真正容易被忽略的点是：每次更换 Qt 版本或重装编译器后，旧项目的构建目录（build-xxx）必须手动删除，否则缓存的 .qmake.stash 和 Makefile 仍指向旧路径，导致 Kit 看似生效，实则构建走错路。