Qt Creator在Windows上需与Qt库和编译器一同安装,单独安装IDE会导致“No valid kits found”错误;必须使用在线安装器配合清华或腾讯云镜像源(如--mirror https://mirrors.tuna.tsinghua.edu.cn/qt/),并勾选Qt Creator、对应编译器(MinGW或MSVC)及匹配的Qt库三者缺一不可。

Qt Creator 在 Windows 上不是独立安装的 IDE,它必须和 Qt 库、编译器一起装——单独下载 Qt Creator 安装包(比如从 download.qt.io/archive/qtcreator/)只能装 IDE,没编译器、没 Qt 库,新建项目会直接报错 “No valid kits found”。
用在线安装器 + 镜像源,5 分钟内完成完整环境部署
官方在线安装器(qt-online-installer-windows-x64-*.exe)体积小(约 20MB),但默认走国外服务器,国内下载 Qt 组件极慢甚至中断。必须加 --mirror 参数指定国内镜像。
- 推荐清华镜像:
qt-online-installer-windows-x64-4.10.0.exe --mirror https://mirrors.tuna.tsinghua.edu.cn/qt/ - 腾讯云镜像也可用:
--mirror https://mirrors.cloud.tencent.com/qt/ - 运行前确认路径不含中文、空格或特殊字符(比如
D:\Qt\installer安全,D:\我的软件\Qt安装器会导致后续 kit 检测失败) - 安装时不要跳过“Tools”目录下的
MinGW或MSVC编译器——它们不在“Qt”节点下,而在“Tools”里,漏选就等于没编译器
安装时必须勾选的三个关键组件
组件页面是安装成败的核心,很多人卡在这里。以下三项缺一不可:
-
Qt Creator(在 Tools → Qt Creator 节点下) - 至少一个编译器套件:如
MinGW 11.2 64-bit或MSVC 2019 64-bit(注意:Qt 6.5+ 已不提供预编译 MinGW,若选 Qt6 请优先选 MSVC) - 对应版本的
Qt库:比如Qt 5.15.2或Qt 6.5.0(必须和所选编译器匹配,MinGW版 Qt 不能配MSVCkit)
其他模块(Charts、Multimedia 等)按需勾选,不影响基础编译。
安装后 kit 不自动识别?检查这三处
启动 Qt Creator 后,如果新建项目提示 “No valid kits found”,不是安装失败,而是路径或权限问题:
- 打开 Tools → Options → Kits,看
Compiler和Qt version是否都显示为 “None” 或红色叹号 - 手动添加编译器:Compilers 标签页 → “Add” → 选择
MinGW的g++.exe(路径类似D:\Qt\Tools\mingw11_64\bin\g++.exe) - 手动添加 Qt 版本:Qt Versions 标签页 → “Add” → 指向
qmake.exe(路径类似D:\Qt\5.15.2\mingw11_64\bin\qmake.exe) - 最后在 Kits 标签页里把刚配好的 Compiler 和 Qt Version 关联起来——名称必须完全匹配,大小写敏感
Qt 5 还是 Qt 6?新手别碰 Qt 6 的 MinGW
Qt 6.5+ 官方不再发布预编译 MinGW 版本,你看到的 MinGW 组件其实是工具链,不是 Qt 库。想用 MinGW 编 Qt6 项目,得自己编译 Qt 源码,耗时数小时且极易出错。
- 稳妥选择:
Qt 5.15.2+MinGW 11.2 64-bit(LTS 版本,文档全、兼容性好) - 若已装 VS2019/2022,可选
MSVC 2019 64-bit+Qt 6.5.0,kit 自动识别率高 - 路径中含空格(如
C:\Program Files\)会导致qmake解析失败,务必用短路径(如D:\Qt)
kit 配好了,但构建时提示 “The code model could not parse” 或 UI 设计器打不开,大概率是 Qt 版本和编译器位数不一致(32-bit Qt 配 64-bit MinGW),这种细节不报错,只静默失效。


















