Kit配置失败主因是编译器、Qt版本、调试器三者未对齐或路径未被识别,需按“No compiler set”等提示逐项检查路径、环境变量及组件兼容性。

Qt Creator环境配置失败,绝大多数情况不是软件损坏,而是Kit三要素(编译器、Qt版本、调试器)没对上,或其中某一项的路径根本没被识别——先别急着重装,按下面几类典型问题对症检查。
Kit显示黄色感叹号,提示“No compiler set”
这是最常见现象,本质是Qt Creator压根没找到你系统里装的编译器可执行文件。
- 打开
工具 → 选项 → 编译器,确认列表里有没有gcc、cl.exe或mingw32-make.exe对应的条目;如果为空,说明Qt Creator没自动扫描到它们 - 手动添加时,路径必须指向具体可执行文件,比如 MinGW 的
C:\Qt\Tools\mingw112_64\bin\g++.exe,不是只填到bin目录 - MSVC 用户要特别注意:不能只装 Visual Studio IDE,必须安装
Visual Studio Build Tools或勾选Desktop development with C++工作负载,否则cl.exe根本不存在 - Linux/macOS 下检查
g++ --version能否在终端直接运行;如果不行,PATH没生效,Qt Creator 启动方式也要改(比如从桌面图标启动会忽略 shell 配置)
构建时报错“Cannot run compiler 'gcc'”或“mingw32-make.exe not found”
报错里出现的具体命令名,就是当前 Kit 正在尝试调用但失败的程序——它要么不在系统 PATH 中,要么 Qt Creator 启动时没继承该环境。
Qt Creator 18.0.2 Windows x86_64 历史版本安装包,适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
- Windows 上打开 CMD,直接输入
mingw32-make --version或g++ --version,如果提示“不是内部或外部命令”,说明PATH没配;此时需把 MinGW 的bin目录(如C:\Qt\Tools\mingw112_64\bin)加进系统环境变量 - Linux/macOS 用户检查
~/.bashrc或~/.zshrc是否 export 过PATH,且 Qt Creator 是从终端执行qtcreator启动的,而非桌面快捷方式(后者不读 shell 配置) - Qt Creator 自带的终端(
帮助 → 启动终端)默认不加载用户 shell 环境,不能用来验证 PATH 是否生效 - MinGW 用户还要确认安装的是完整工具链,不是只有 Qt 库;
mingw32-make.exe属于 MinGW-w64 工具集,不是 Qt 自带的
Qt 版本下拉列表为空,或提示“Qt version is not properly installed”
这表示 Qt Creator 找到了 qmake,但运行它时出错,常见于路径含空格、权限不足或依赖缺失。
- 检查
qmake路径是否正确,比如 Windows 上应为C:\Qt\6.8.3\msvc2019_64\bin\qmake.exe,不能漏掉\bin\或写成\lib\ - Linux 下若提示
libQt6Core.so.6: cannot open shared object file,大概率是LD_LIBRARY_PATH冲突(比如 ~/.bashrc 里硬写了旧版 Qt 的 lib 路径),注释掉再试 - macOS 上遇到
Library not loaded: @rpath/...,说明 Qt 安装包未正确签名或路径未重写,优先用官方在线安装器安装,避免手动移动目录 - Qt 6.7+ 用户注意:某些组件(如
Qt WebEngine)需单独勾选安装,否则qmake -query可能返回不完整信息,导致 Kit 校验失败
配置完成后仍构建失败,CMake 报“C++ compiler is not able to compile a simple test program”
这类错误往往发生在 Qt 6 + MSVC 组合,根源是 VS 的环境变量(如 INCLUDE、LIB、VCINSTALLDIR)根本没加载进 Qt Creator 进程。
- 不要依赖 Qt Creator 自动探测 MSVC 环境;必须先在 CMD 中运行
"C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars64.bat",再从该 CMD 启动qtcreator - Qt Creator 默认使用 Ninja 生成器,但它在 Windows 上对 MSVC 环境兼容性差;改为
Visual Studio 17 2022生成器(CMake 配置页里选),成功率大幅提升 - 检查 Windows SDK 版本是否匹配:Qt 6.8.3 要求 Windows 10/11 SDK 10.0.22621.0 或更高,旧版 SDK 会导致
kernel32.lib找不到 - 构建前务必清理旧的
build目录,CMake 缓存(CMakeCache.txt)里可能残留错误的编译器路径
真正卡住人的地方,往往不是某一步操作错了,而是多个环节的路径和环境变量彼此脱节——比如系统 PATH 有 g++,但 Qt Creator 启动时没读它;或者 qmake 能运行,但调用它时又去加载了另一套冲突的 Qt 库。验证时一定要分清楚:是在终端里试,还是在 Qt Creator 内置终端里试,还是直接双击图标启动的 Qt Creator —— 它们看到的环境可能完全不同。

















