Qt Creator安装后需手动配置Kit才能运行项目，必须同时指定编译器（如MinGW/g++）、Qt版本（qmake路径）和调试器（如GDB），三者缺一不可且须ABI兼容。
Qt Creator 安装完不能直接写代码跑起来——它不自带编译器、不自动绑定 Qt 库、也不默认识别你系统里已有的工具链。配置不到位，新建项目点“运行”就报错，比如 qmake: command not found 或 No valid kits found。
Kit（构建套件）为空或标红？先确认编译器和 Qt 版本是否被识别
这是新手最常卡住的地方。Qt Creator 启动后，打开「工具 → 选项 → 构建和运行」，在 Kits 标签页下，如果列表为空或某 Kit 显示红色感叹号，说明至少缺以下一项：
-
Compiler（编译器）未添加：Linux/macOS 默认用gcc/clang，Windows 用MinGW或MSVC；需手动指定路径，如/usr/bin/g++或C:\Qt\Tools\mingw81_64\bin\g++.exe -
Qt version未注册：qmake 路径必须指向真实可执行文件，例如/opt/Qt5.15.2/bin/qmake；若权限不足，运行chmod +x /path/to/qmake - 三者未正确关联：Kit 必须同时选中一个 Compiler、一个 Debugger（如
gdb或lldb）、一个 Qt version；缺一不可
Windows 下 MinGW 套件找不到？别只装 Qt Creator
官方在线安装器默认只装 IDE，不装编译器和 Qt 库。如果你只下载了 Qt Creator 单独安装包（比如 qtcreator-10.0.1-windows-x86_64.exe），那 Kits 里必然空空如也。
Qt Creator 18.0.2
下载
Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
- 必须重装完整包：从官网或清华镜像站下载带组件的离线包，如
qt-opensource-windows-x64-5.15.2.exe - 安装时务必勾选：
MinGW 8.1.0 64-bit（或对应版本） +Qt 5.15.2（或你想要的版本） +Qt Creator - 不要跳过「Tools」目录下的子项——
MinGW不在「Developer and Designer Tools」里，而在「Tools」展开后
macOS 上 clang 报错“cannot find -lQt5Core”？环境变量没导对
Homebrew 安装的 Qt 默认路径是 /opt/homebrew/opt/qt（M 系列芯片）或 /usr/local/opt/qt（Intel），但 qmake 和链接器不一定能自动找到库。
- 检查
qmake -query输出，确认QT_INSTALL_LIBS指向正确路径 - 在
~/.zshrc中补全两行（注意路径与你实际安装一致）：export PATH="/opt/homebrew/opt/qt/bin:$PATH"export DYLD_LIBRARY_PATH="/opt/homebrew/opt/qt/lib:$DYLD_LIBRARY_PATH" - 重启终端或运行
source ~/.zshrc，再启动Qt Creator，否则 Kit 仍会识别失败
Ubuntu 下 Kit 显示 “Debugger not found”？GDB 权限或路径不对
即使系统已装 gdb，Qt Creator 也可能因权限或路径问题无法调用。
- 先验证：
which gdb应输出类似/usr/bin/gdb；若无，运行sudo apt install gdb - 在「构建和运行 → 调试器」中点击「Add」，类型选
System GDB，路径填/usr/bin/gdb - 若仍报错，可能是
gdb缺少 Python 支持（Ubuntu 22.04+ 默认不带）：装gdb-python3包即可
MinGW 8.1 编译的 Qt 库，就不能混用 MinGW 11 的 Kit；Qt 6 的 qmake 也不能驱动 Qt 5 的项目。这些细节不显眼，但一旦错配，错误信息往往模糊，排查起来比重装还耗时间。 
