qt creator首次启动需手动配置编译器、qt版本和kit，否则新建项目会报“kit is not valid”或卡在套件选择页；须进入“工具→选项→构建与运行”，依次在compilers、qt versions、kits中确认或添加对应路径并关联。
Qt Creator 第一次启动时不会自动完成可用编译器和 Qt 版本的配置，必须手动确认或补全，否则新建项目会报 Kit is not valid 或直接卡在构建套件选择页。
启动后立即检查“构建与运行”设置
安装完 Qt Creator（如 5.14.2 或更高版本）并首次启动，它可能只检测到部分工具链，甚至完全没识别出 MinGW 或 MSVC。这不是异常，是默认行为。
- 进入 工具 → 选项 → 构建与运行，切到
Compilers标签页：确认是否已列出MinGW 7.3.0 64-bit（Windows）或clang（macOS）；若为空，点击Add手动添加，路径通常为：D:\Qt\Tools\mingw73_64\bin\g++.exe（Windows）或/opt/homebrew/opt/qt/bin/qmake（macOS，需先装 Homebrew + qt） - 切到
Qt Versions标签页：确保已添加对应 Qt 版本，例如Qt 5.14.2，qmake 路径应指向D:\Qt\5.14.2\mingw73_64\bin\qmake.exe；macOS 下通常是/opt/homebrew/Cellar/qt/6.5.3/bin/qmake - 最后切到
Kits标签页：这里会自动生成一个默认 Kit（如Desktop Qt 5.14.2 MinGW 64-bit），但需手动勾选它右侧的Auto-detected并确认编译器、Qt 版本、调试器三项都已正确关联；任一为空即为无效 Kit
Windows 下 MinGW 路径不识别的常见原因
即使你安装时勾选了 MinGW 组件，Qt Creator 仍可能找不到，因为安装器有时把工具链装到了非标准路径，或环境变量未生效。
Qt Creator 18.0.2
下载
Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
-
g++.exe实际位置可能在D:\Qt\Tools\mingw73_64\bin\，而非D:\Qt\5.14.2\mingw73_64\bin\—— 后者是 Qt 库路径，前者才是编译器路径 - 路径中含空格或中文（如
C:\Program Files\...或D:\我的项目\）会导致 Kit 校验失败，必须改用纯英文无空格路径 - 杀毒软件或 Windows Defender 临时拦截
g++.exe执行，表现为“无法启动编译器”，可尝试右键该文件 → 属性 → 解除锁定
macOS 上必须先装 Xcode 命令行工具
Homebrew 安装的 Qt 依赖系统级 clang 和 make，而 Qt Creator 不会主动提示你缺这些底层工具。
- 终端执行
xcode-select --install是强制前置步骤，跳过则qmake生成的 Makefile 会因找不到clang++而构建失败 - Homebrew 安装 Qt 后，
qmake路径是/opt/homebrew/opt/qt/bin/qmake，但 Qt Creator 的Qt Versions页面里填这个路径仍可能报错；正确做法是填/opt/homebrew/Cellar/qt/6.5.3/bin/qmake（具体子目录名以brew --prefix qt输出为准） - Shell 配置文件（
~/.zshrc）里加的PATH对 Qt Creator GUI 启动方式无效，必须在 Kits 里显式指定完整路径
Kit 配置不是“一次做完就永远有效”的事情——换 Qt 版本、重装系统、升级 Xcode 或 Homebrew 更新 Qt 后，Kit 都可能变灰失效。每次遇到构建失败，第一反应不是改代码，而是打开 构建与运行 → Kits 看那个绿色对勾还在不在。
