Kit配置失败本质是Qt Version、Compiler、Debugger三者未对齐,缺一不可;任一组件缺失、路径错误、ABI不匹配或版本冲突均导致Kit标红叹号,需逐一验证qmake--version、编译器可用性及调试器ABI一致性。

Kit 配置失败,本质是 Qt Version、Compiler、Debugger 三者没对齐 —— 缺一不可,错一个就标红叹号。
Qt Versions 里找不到 qmake 或标红
Qt Creator 不会自动识别你本地装的 Qt,哪怕路径正确,也可能因为权限、符号链接或 qmake 自身报错被忽略。
- 手动添加时,
qmake路径必须指向可执行文件(如/opt/Qt/6.5.3/gcc_64/bin/qmake),不能只选到bin目录 - 运行
qmake --version确认它能正常输出;如果报错libstdc++.so.6: version `GLIBCXX_3.4.29' not found,说明 Qt 版本和系统 glibc 不兼容,得换匹配的 Qt 或升级系统 - 交叉编译场景下,
qmake必须是目标平台编译出来的(比如 ARM 的qmake),不能用 x86 主机版的
Compiler 显示 “No compiler set” 或 ABI 不匹配
常见于 Windows 上 MSVC 套件,或 Linux 交叉编译链未正确注册。
Qt Creator 18.0.2 Windows x86_64 历史版本安装包,适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
- MinGW 用户检查
gcc和g++是否在同目录、版本一致(如都来自mingw1120_64);混用mingw73_64和mingw1120_64会导致 Kit 无效 - MSVC 用户注意:Kit 中选的 Compiler 名称(如
Microsoft Visual C++ Compiler 14.3)必须和qmake内置支持的 mkspec 一致,否则即使路径对也会标黄 - 交叉编译时,
arm-poky-linux-gnueabi-gcc和arm-poky-linux-gnueabi-g++必须成对添加,且 ABI(如arm-linux-generic-elf-64bit)需与 Debugger 严格一致
Kit 列表里全是黄色感叹号
不是“没配好”,而是“配了但不自洽”——最常踩的坑是 Debugger 和 Compiler 的 ABI 对不上。
- 用 MinGW 编译,就必须配 GDB(不是 LLDB);用 MSVC 编译,必须配 CDB(Windows SDK 自带)
- 查 ABI:点开 Kit → 展开 Compiler 和 Debugger 两栏,看末尾字符串是否一致(如都是
x86-windows-msvc2019-pe-64bit) - 若 Debugger 自动检测出错(比如 GDB 版本太新,不支持 DWARF5),手动指定旧版
gdb.exe路径,或改用gdb -i=mi2启动参数绕过
新建项目时 Kit 下拉为空或灰色不可选
Kit 本身可能已配置成功,但没绑定到当前项目。
- 打开项目后,左侧切换到
Projects标签页 → 点击当前 Kit 名称(如Desktop Qt 6.5.3 MinGW 64-bit)→ 右侧勾选Use this kit for all build configurations - 如果项目是 CMake 项目,确保
CMakeLists.txt里project()声明的最低 Qt 版本 ≤ 你配置的 Qt Version(如写project(MyApp LANGUAGES CXX VERSION 6.6),但只装了 6.5.3,Kit 就不会激活) - Linux 下用 sudo 启动 Qt Creator,会导致环境变量丢失(如
PATH、QMAKE_SPEC),Kit 找不到工具链 —— 永远用普通用户启动
Kit 不是“一次配完就万事大吉”的配置项,每次 Qt、编译器或系统更新后,ABI 兼容性都可能被打破。真正麻烦的从来不是加 Kit,而是验证三者握手成功那一刻 —— qmake 能跑、g++ 能编、gdb 能断,缺一不可。

















