qt creator不绑定特定qt版本,需根据项目需求选择匹配的qmake路径、编译器和模板;必须指定bin/qmake.exe路径,确保kit中compiler、debugger、qt version abi一致,并按qt5/qt6差异选用对应模板与语法。

Qt Creator 本身不绑定特定 Qt 版本,选哪个版本取决于你项目的真实需求——不是看 IDE 版本号,而是看 qmake 路径是否匹配、编译器是否兼容、项目模板是否支持。
Qt Versions 页面里添加的是 qmake,不是 Qt 安装目录
很多人误点 Qt 根目录或 lib 目录,结果添加失败或后续构建报错 qmake: could not exec。必须定位到每个 Qt 版本下的 bin/qmake.exe(Windows)或 bin/qmake(Linux/macOS)。
- Qt 5.14.2 对应路径示例:
C:\Qt\5.14.2\mingw73_64\bin\qmake.exe - Qt 6.5.3 对应路径示例:
C:\Qt\6.5.3\mingw_64\bin\qmake.exe(注意:Qt6 默认用 CMake,但qmake仍存在,仅限 compat 项目) - 如果路径中含空格或中文,Qt Creator 可能静默失败——建议安装路径全英文、无空格
Kit 配置时编译器和 Qt 版本必须“对得上”
Qt 5.14.2 + MSVC2017 和 Qt 6.5.3 + MSVC2022 是常见组合,混搭大概率触发 undefined reference to `QApplication::QApplication(int&, char**) 类链接错误。
Qt Creator 18.0.2 Windows x86_64 历史版本安装包,适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
- Qt 5 系列通常依赖
MSVC2015/2017或MingW 7.3;Qt 6 系列要求MSVC2019/2022或MingW 11.2+ - 同一套 Kit 中,
Compiler、Debugger、Qt version三者 ABI 必须一致(比如都是 x86_64、都是 Windows MSVC) - Qt 6 的 CMake 项目不需要
qmake,但 Kit 里仍需指定对应 Qt 版本的cmake路径(如C:\Qt\6.5.3\msvc2022_64\lib\cmake\Qt6不是路径,而是通过 CMake 工具链识别)
新建项目时模板决定 Qt 版本上限
选错模板,下拉菜单里根本看不到 Qt 5.15 —— 因为 Qt Quick Application(无后缀)默认只列 Qt 6.x;要建 Qt5 项目,必须选 Qt Quick Application (compat)。
- Qt 5.15 项目:用
Qt Widgets Application或Qt Quick Application (compat)模板 - Qt 6.5+ 项目:优先用
Qt Quick Application(CMake)或Qt Quick Controls 2 Application - 若项目已存在,不要靠“重选 Qt version”硬切——先确认
.pro文件里有QT += widgets(Qt5)或find_package(Qt6 REQUIRED COMPONENTS Core Widgets)(Qt6),否则 Kit 切换无效
最容易被忽略的一点:Qt 5 和 Qt 6 的信号槽语法、模块命名(QtQuick.Controls vs QtQuick.Controls.impl)、甚至资源文件 .qrc 解析方式都不同。Kit 配好了不代表代码能跑通——版本切换后务必检查 #include、QML import 和构建日志里的 first error。










