Qt Creator通过构建套件(Kit)管理Qt版本,添加新版本需在“工具→选项→构建与运行→Qt版本”中点击“添加”,指定对应qmake路径;Kit必须包含匹配的编译器、调试器和Qt版本三要素,切换项目Qt版本需更换完整Kit而非仅改Qt版本下拉项。

Qt Creator 本身不绑定某个 Qt 版本,它只是调用你本地已安装的 qmake 或 cmake 来构建项目。真正决定用哪个 Qt 版本的,是你为项目配置的「构建套件(Kit)」——而 Kit 的核心依赖项之一,就是你指定的 Qt Version。
怎么在 Qt Creator 里添加一个新 Qt 版本?
添加本质是告诉 Qt Creator:某个路径下的 qmake 属于哪个 Qt 版本。它不会复制或安装 Qt,只做识别和引用。
- 打开 工具 → 选项 → 构建与运行 → Qt 版本
- 点击 添加,然后定位到你 Qt 安装目录下的
bin/qmake(Windows)或bin/qmake(macOS/Linux) - Qt Creator 会自动读取该
qmake所属的 Qt 版本号并显示名称,比如Qt 5.15.2 MinGW 64-bit - 如果路径下没有
qmake(例如你只装了 Qt 6 的cmake工具链),这个版本就无法被识别为传统 Qt Version;Qt 6 项目需走 CMake 流程,不依赖qmake
为什么选了 Qt 版本,项目还是编译失败?
常见原因不是 Qt 版本没选对,而是「构建套件(Kit)」没配全。Qt Version 只是 Kit 的一部分,Kit 还必须包含匹配的编译器和调试器。
- 在 构建与运行 → 构建套件 中,每个 Kit 都有三要素:
Compiler、Debugger、Qt Version - 比如你选了
Qt 5.15.2 MinGW 64-bit,但 Kit 里配的是MSVC 2019 x64编译器 —— 这个 Kit 就无效,Qt Creator 会标黄警告 - MinGW 版 Qt 必须配 MinGW 编译器;MSVC 版 Qt 必须配对应 MSVC 工具链;Clang 版同理
- 调试器缺失(如 Windows 下没装
gdb或cdb)会导致 Kit 可用但无法调试
怎么给已有项目切换 Qt 版本?
不能直接改“Qt 版本”下拉框,必须换 Kit。因为 Qt 版本是 Kit 的属性,不是项目的独立设置。
- 打开项目后,点左侧 项目(Projects) 按钮(不是“文件”菜单)
- 在 构建与运行 区域,找到 构建套件(Kit) 下拉菜单
- 从列表中选择一个已配置好、且包含目标 Qt 版本的 Kit(例如
Desktop Qt 5.12.12 MinGW 64-bit) - 切换后,记得点击右下角 应用(Apply),否则配置不生效
- 如果目标 Kit 不在列表里,说明它还没被创建或未通过验证(比如编译器路径错误),需要先回“选项”里修复
最常被忽略的一点:Qt 5 和 Qt 6 的项目结构和构建方式不同。Qt 6 默认弃用 qmake,改用 CMake + find_package(Qt6)。如果你强行把 Qt 6 的 qmake 路径加进 Qt Versions 列表,它可能显示成功,但新建项目时仍会提示“no valid kits”,因为 Qt Creator 6+ 已不再默认支持 qmake for Qt 6。这时候你得手动创建基于 CMake 的 Kit,并确保 CMake 配置指向正确的 Qt 6 安装路径。


















