qt creator本身不自带编译器和qt库,kit配置失败是运行环境问题的根源,典型表现为“no valid kits found”或平台插件缺失错误,主因包括未安装配套编译器、qt路径变更、环境变量未配置及工具链未正确关联。

Qt Creator 本身不自带编译器和 Qt 库,运行环境配置失败的根源几乎都出在 Kit 没对上——不是 IDE 装得不对,而是它找不到可用的编译器、调试器或 Qt 版本。
Kit 配置失败的典型现象
新建项目后点击「构建」直接报错:No valid kits found;或者构建成功但运行时弹窗提示 Cannot find Qt platform plugin "windows"(Windows)或类似路径缺失错误。这说明 Qt Creator 已启动,但底层工具链未连通。
常见原因包括:
- 安装时没勾选编译器(比如只装了 Qt Creator,漏掉
MinGW或MSVC) - Qt 版本路径被移动或重命名,
Tools > Options > Kits里显示红色感叹号 - 系统环境变量没加,导致
qmake、moc等命令在终端中也执行不了
Windows 下 MinGW Kit 的手动补救步骤
如果安装后 Kit 显示为灰色或不可用,别急着重装,先检查并手动补全:
- 确认
MinGW安装路径存在,例如C:\Qt\Tools\mingw1120_64\bin\g++.exe(版本号可能不同) - 打开
Tools > Options > Kits > Compilers,点击「Add」→「GCC」→ 填入g++.exe路径 - 再进
Kits标签页,新建或编辑一个 Kit,分别指定:-
Compiler:刚添加的 GCC -
Debugger:对应gdb.exe(通常在同一目录下) -
Qt version:选已安装的Qt 6.5.0 MinGW 64-bit(若没有,先去Qt Versions标签页添加qmake.exe路径)
-
- 保存后,回到项目界面左下角「Build & Run」,确认当前 Kit 名称旁无警告图标
macOS 上 clang Kit 必须依赖 Xcode 命令行工具
即使你没装 Xcode.app,clang 和 lldb 也必须通过 Apple 官方渠道提供——Homebrew 安装的 llvm 默认不被 Qt Creator 认可。
Qt Creator 18.0.2 Windows x86_64 历史版本安装包,适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
验证和修复方式:
- 终端运行
xcode-select --install,完成安装后执行clang --version和lldb --version确认输出正常 - Qt Creator 中的
Compiler类型选「Clang」,路径填/usr/bin/clang++(不是 Homebrew 的/opt/homebrew/bin/clang++) -
Debugger必须选LLDB,路径为/usr/bin/lldb;选 GDB 会失败 - Qt 版本需匹配 macOS SDK,例如
Qt 6.5.0 for macOS,不能混用 Linux 或 Windows 的 Qt 包
环境变量 PATH 是隐藏故障点
很多问题表面是 Kit 报错,实际是 qmake 在构建时调用失败,而 Qt Creator 有时不把这类错误直观展示出来。
务必确保以下路径已加入系统 PATH:
- Qt 安装目录下的
bin(如C:\Qt\6.5.0\mingw_64\bin或/opt/homebrew/opt/qt/bin) - 编译器所在
bin目录(如C:\Qt\Tools\mingw1120_64\bin) - 修改后重启 Qt Creator(不是仅关闭项目),否则新 PATH 不生效
验证方法:在 Qt Creator 内置终端(Ctrl+Shift+T)中输入 qmake -v 和 g++ --version,都能正常返回才真正就绪。










