Qt Creator 与 Qt 6 是分离安装关系:需先用官方在线安装器独立安装 Qt 6(如 D:\Qt\6.5.3\mingw_64),再在 Qt Creator 的“工具→选项→Kits→Qt Versions”中手动添加其 bin/qmake-qt6.exe 路径,最后新建 Kit 并绑定该 Qt 版本及匹配编译器。

Qt Creator 和 Qt 6 不是“配合安装”的关系,而是:先装 Qt 6(含其 qmake-qt6 或 cmake 工具),再让 Qt Creator 识别它。直接装一个带 Qt Creator 的 Qt 安装包,大概率会把旧版 Qt Creator 和 Qt 6 绑死,后续想加 Qt 5 或换编译器就容易卡住。
Qt 6 本体必须独立安装,别指望 Qt Creator 自带的“Qt”够用
Qt Creator 安装包里附带的 Qt 版本(比如随 Qt Creator 11.0.3 一起下载的 Qt 6.5.3)只是个默认选项,路径固定、组件精简,且无法通过 MaintenanceTool 管理更新。真正要稳定开发,得用官方在线安装器单独装 Qt 6:
- 去 qt.io/download 下载
qt-unified-windows-x64-4.x.x-online.exe(Windows)或对应 macOS/Linux 安装器 - 登录账号后,在组件选择页展开
Qt→Qt 6.x.x→ 勾选完整 Desktop 套件,例如:MinGW 11.2_64或MSVC 2022_64 - 关键:取消勾选“Qt Creator”组件——你已有独立 Qt Creator,不需要重复安装
- 安装路径建议设为
D:\Qt\6.5.3\mingw_64这类明确带版本号和编译器名的路径,避免和 Qt 5 混淆
Qt Creator 怎么找到你装的 Qt 6?靠手动注册 qmake-qt6
Qt Creator 不会自动扫描系统找 Qt 6,必须手动告诉它 qmake-qt6 在哪。打开 Qt Creator → 工具 → 选项 → Kits → Qt Versions:
- 点击“添加”,定位到你刚装的 Qt 6 目录下的
bin/qmake-qt6.exe(Windows)或bin/qmake-qt6(Linux/macOS) - 如果提示“qmake not found”,说明路径错了——常见错误是选了
qmake(那是 Qt 5 的)或cmake - 注册成功后,回到 Kits 标签页,新建 Kit:名称写“Desktop Qt 6.5.3 MinGW”,Qt version 选刚注册的那个,Compiler 选匹配的 MinGW 或 MSVC
- Kit 名称里务必包含
Qt 6字样,否则项目切换时极易选错
装完 Qt 6 后,QT_SELECT=qt6 这个环境变量要不要设?
Linux/macOS 用户常看到教程让加 export QT_SELECT=qt6 到 ~/.bashrc,这其实是个陷阱:
- 这个变量只影响命令行下
qmake默认调用哪个版本,但 Qt Creator 完全不读它——它只认你在 Kit 里配的qmake-qt6路径 - 设了反而可能导致终端里
qmake指向 Qt 6,而你某个 Qt 5 项目用qmake命令构建时出错 - 真正需要的是确保
qmake-qt6和qmake-qt5都在PATH里,且名字不冲突(Ubuntu/Debian 系发行版默认已做)
验证是否真能用:新建项目时别选错模板
Qt Creator 新建项目时,默认模板可能仍基于 Qt 5,尤其当你之前装过 Qt 5:
- 点 文件 → 新建文件或项目 → Application → Qt Widgets Application
- 下一步后,在“Kit”选择界面,**必须手动勾选你刚配好的 Qt 6 Kit**,不能依赖默认项
- 生成的
.pro文件第一行应该是QT += core gui widgets,而不是QT += core gui(后者可能是 Qt 6 的 Quick 项目) - 编译前看左下角构建套件名称,确认显示的是 “Desktop Qt 6.5.3 MinGW” 这类带 Qt 6 字样的 Kit
真正的麻烦不在安装,而在 Kit 配置时路径写错、编译器不匹配、或者新建项目时没手动选 Kit —— 这些地方一错,报错信息全是英文且指向模糊,但根源就在这几步里。


















