根本原因是编译器未就绪或Kit配置断裂，需先验证gcc/cl/clang++是否可用，再手动配置编译器路径、绑定Qt版本与调试器，最后清除缓存强制重载环境。
Qt Creator构建失败时，项目无法生成可执行文件，绿色三角形按钮点击后只输出红色错误日志，根本原因几乎都指向编译器未就绪或Kit配置断裂。
先确认编译器是否真实可用
打开系统终端（Windows用CMD/PowerShell，macOS/Linux用Terminal），逐条运行以下命令：
gcc --version → 若提示“不是内部或外部命令”，说明MinGW未安装或PATH未包含其bin目录；
cl → Windows下若报错“无法识别”，需启动Visual Studio的Developer Command Prompt再试；
clang++ --version → 返回版本号才代表LLVM工具链完整，仅装Clang前端不等于有配套链接器和标准库。
这一步跳过直接进Qt Creator配置，等于在没检查发动机油量的情况下点火——所有后续操作都建立在编译器能独立运行的前提上。
手动添加编译器路径（MinGW/MSVC/Clang三选一）
方法一：MinGW（最常见）
进入“工具→选项→Kits→编译器”，点击“Add→MinGW→C”，浏览到类似 【C:\Qt\Tools\mingw132_64\bin\gcc.exe】 的路径；
再添加C++编译器，路径必须是同目录下的g++.exe，不能混用不同版本MinGW的gcc和g++；
方法二：MSVC
添加C编译器时选择 【C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.39.33519\bin\Hostx64\x64\cl.exe】（路径以你实际安装的VS版本为准）；
注意：不要选“x86”子目录下的cl.exe，64位Qt必须配64位编译器，否则Kit会显示黄色感叹号；
方法三：Clang
添加C编译器指向clang.exe，C++编译器指向clang++，两者必须来自同一LLVM安装包；
若从llvm.org下载预编译包，解压后bin目录下必须同时存在clang、clang++、lld-link三个可执行文件，缺一则构建中断。
修复Kit三大组件绑定关系
第一步：确认Qt版本已注册
在“Kits→Qt Versions”页点击“Auto-detect”，若无结果，手动添加qmake.exe路径，例如 【C:\Qt.7.2\mingw_64\bin\qmake.exe】；
Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
第二步：检查调试器是否存在
切换到“Debuggers”页，GDB路径应为MinGW同级目录下的gdb.exe，CDB路径需指向VS安装目录中的cdb.exe；
第三步：创建新Kit并强制绑定
点击“Kits”页的“Add”，名称填“Desktop Qt 6.7.2 MinGW 64-bit”，Device type选Desktop；
Compiler(C)和Compiler(C++)必须分别选中你刚添加的gcc和g++；
Debugger必须选对应架构的GDB（如x86_64-w64-mingw32-gdb.exe）；
Qt version下拉框里只能出现你手动添加成功的那个条目，若为空白，说明qmake路径错误或qmake.conf损坏；
最后勾选“Use this kit by default for new projects”，避免每次新建项目都重新选。
验证CMake项目专用配置
如果项目使用CMakeLists.txt而非.pro文件，Kit页面中必须指定CMake Tool：
点击“CMake Tools”标签→“Add”→浏览到cmake.exe（如C:\Program Files\CMake\bin\cmake.exe）；
回到“Kits”页，在新建Kit的“CMake Tool”下拉框中选中该条目；
不配置此项会导致CMake项目构建时提示“CMake executable not found”，且错误信息藏在“General Messages”面板而非构建输出窗口；
若使用Ninja加速构建，需额外在CMake Tool配置中勾选“Use Ninja generator”，否则仍走默认Makefile流程，无法利用并行编译优势。
清除缓存强制重载环境
关闭Qt Creator；
删除用户配置目录下的缓存文件夹：Windows是%LOCALAPPDATA%\QtProject\qtcreator，macOS是~/Library/Caches/QtProject/qtcreator，Linux是~/.cache/QtProject/qtcreator；
重启Qt Creator，此时所有自动检测逻辑将重新扫描系统PATH、注册表（Windows）或pkg-config（Linux），绕过旧缓存导致的路径误判；
这一步能解决“明明PATH已更新，Qt Creator却坚持用旧路径”的顽疾，因为它的缓存不会随系统环境变量实时刷新。
