必须用官方在线安装器统一安装qt sdk+qt creator，否则kit无法识别、右下角持续报红感叹号；安装路径禁用中文、空格、符号，需手动在kits中配置msvc编译器、qt版本及调试器。

Qt Creator 不是独立安装的 IDE，它随 Qt SDK 一起分发。直接下载安装 Qt Creator 独立包（比如旧版 standalone installer）已不推荐，且容易缺编译器、Kit 不识别、右下角持续报红感叹号。 必须用官方在线安装器统一安装 Qt SDK + Qt Creator，否则后续新建项目大概率失败。

用 qt-unified-windows-x86 安装器才是唯一可靠路径

去 https://www.php.cn/link/ed2a813dab400b3fee9a1e5e93b03122 下载最新 qt-unified-windows-x86-*.exe（如 qt-unified-windows-x86-4.1.0-online.exe）。别从第三方镜像或旧存档页（如 /archive/qt/）下载离线包——那些不含 Qt Creator 或版本严重滞后。

关键点：

• 必须以管理员身份运行安装器，否则写入注册表和系统路径可能失败
• 安装过程中断网可跳过 Qt 账号登录（临时方案），但后续更新组件需登录
• “Custom installation” 模式下，务必勾选你实际要用的 Qt 版本（如 Qt 6.7.2）+ 对应编译器（如 MSVC 2022 或 MinGW 11.2）+ Qt Creator 工具本身（在 Developer Tools 分类里）
• 如果只勾了 Qt 版本没勾 Qt Creator，安装完打开的是空白界面或报 Could not start Qt Creator

安装路径不能含中文、空格、符号

这是 Windows 下最常被忽略却导致 qmake 找不到、Kit 显示 “No compiler specified” 的原因。

错误示例：C:\Program Files\Qt、D:\我的开发工具\Qt、E:\Qt 6.7

正确写法：D:\Qt\672\msvc2022_64 或 C:\Qt\672\mingw11_64

注意：

• 路径中不能出现任何中文字符、空格、括号、顿号等 Unicode 字符
• 建议用纯英文 + 数字 + 下划线，层级尽量扁平（避免嵌套过深）
• 该路径会成为所有 Kit 的默认 base，改错后重装成本很高

安装后 Kit 不识别 MSVC 或 MinGW 怎么办

不是安装失败，而是 Qt Creator 启动时没自动扫描到已存在的编译器。常见于：

Qt Creator 18.0.2

Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。

下载

• 先装 Qt，再装 Visual Studio —— Qt Creator 启动早于 VS 注册表写入完成
• MinGW 安装目录没被加入 PATH，或版本与 Qt 组件不匹配（如 Qt 6.7 要求 MinGW 11.2，装了 13.x 就不认）
• VS 安装时没勾选 “C++ build tools” 或 “Windows 10/11 SDK”

解决方法：

打开 Qt Creator → 工具 → 选项 → Kits，手动添加：

• Compiler：点 “Add” → “Microsoft Visual C++ Compiler for x64”，路径填 C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.39.33519\bin\Hostx64\x64\cl.exe（版本号随 VS 更新变化）
• Qt version：点 “Add” → 选 D:\Qt\672\msvc2022_64\bin\qmake.exe
• Debugger：选 C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\Packages\Debugger\miengine\bin\QtCreator\gdb\gdb.exe（MSVC 不用 gdb，但 Qt Creator 仍要填）

填完点击 “Apply”，Kit 列表里会出现带绿色对勾的新项。

启动后右下角一直显示红色感叹号

这不是警告，是明确报错：Kit 缺组件。常见组合：

• No valid kits found → 缺编译器或 Qt 版本未注册
• Debugger not found → 未配置调试器，或 VS 安装不完整（缺 Windows SDK）
• Cannot run compiler 'cl.exe' → cl.exe 路径错，或权限被杀毒软件拦截

不要点 “Ignore”，也不要关掉提示栏——它不会自己消失。必须逐项检查 Kits 页面里的黄色叹号图标，鼠标悬停看具体哪一项缺失，再回溯补装对应组件（用 MaintenanceTool.exe 添加）。

特别注意：MSVC Kit 必须搭配同架构的 Qt 版本（x64 Kit 配 x64 Qt），混用 x86/x64 会导致链接失败但错误信息极不直观。