Qt Creator 编译失败主因是Kit未正确配置，表现为“Unconfigured”或红叉，需检查编译器、Qt版本、调试器三者ABI匹配，并确保环境变量生效及路径无中文空格。
Qt Creator 安装后不能编译，90% 的情况不是代码问题，而是 Kit 没真正“活”起来——它卡在编译器、Qt 版本、调试器三者没对上号这一步。
Kit 显示 “Unconfigured” 或红色感叹号
这是最常见表象，本质是 Qt Creator 没法把编译动作调度出去。重点看 Projects → Build & Run → Kits 页面：
- 如果 Kit 名称右侧显示
Unconfigured或图标带红叉，说明至少缺一个环节：编译器未注册、Qt 版本路径无效、或调试器 ABI 不匹配 - 点开该 Kit，检查
Compiler下拉菜单是否为空或显示None；若为空，说明 Qt Creator 根本没扫描到任何可用编译器 - 即使下拉里有选项，也要确认它和你选的 Qt 版本 ABI 一致：比如
Qt 6.7.2 for MinGW 64-bit必须配MinGW 11.2 64-bit，混用MinGW 13.2或MSVC 2022就会灰显
编译器列表为空，但终端里 g++ --version 能跑
这是环境隔离导致的典型假象：Qt Creator 启动时没继承你的 shell 环境变量。
- Windows 用户：从开始菜单启动的 Qt Creator 默认不读取
PATH注册表项或用户环境变量；解决方法是右键开始菜单图标 → “更多” → “以管理员身份运行”，或改用命令行启动：start qtcreator.exe（前提是已将 Qt Creator 安装目录加入系统PATH） - macOS 用户：Finder 启动的 Qt Creator 不加载
~/.zshrc；可在终端执行open -a "Qt Creator"启动，确保环境变量生效 - Linux 用户：桌面快捷方式常绕过 shell 配置；建议直接在终端运行
qtcreator，或编辑快捷方式的Exec=行，改为bash -i -c "qtcreator %F"
选了 MSVC Kit 却报 No C++ compiler set in kit
MSVC 不是独立安装包，它依赖 Visual Studio 完整安装 + 正确注册的工作负载。
- 必须确认已安装 Visual Studio（如 VS 2022），且勾选了
C++ desktop development工作负载 - Qt Creator 需要调用
vcvarsall.bat来提取编译器路径；如果 VS 安装路径含空格或中文（如C:\Program Files\Microsoft Visual Studio\2022\Community），Qt Creator 可能解析失败 —— 建议重装 VS 到纯英文无空格路径（如C:\VS2022） - Qt 官方预编译版通常只提供对应 MSVC 版本的 Qt 库（如
Qt 5.15.2 for MSVC 2019 64-bit），不能混用 VS 2022 编译器去链接 VS 2019 构建的 Qt 库
构建时报 cannot open output file 或中文字符串编译失败
这类错误看似编译失败，实则发生在链接或源码解析阶段，和 Kit 配置无关，但容易被误判。
-
cannot open output file多半是权限或杀软拦截：检查项目build目录是否被 360/火绒等安全软件锁定；Windows 下尝试关闭实时防护，或以管理员身份运行 Qt Creator - 中文字符串报
C2001: newline in constant或C4819：说明源文件编码与编译器预期不一致；必须统一为UTF-8（无 BOM 更稳妥），并在 MSVC 下加#pragma execution_character_set("utf-8")；Qt Creator 中设置路径为Tools → Options → Text Editor → Behavior → Default encoding: UTF-8 - 路径含中文或空格也会触发类似错误：项目路径、Qt 安装路径、甚至用户名含中文都可能导致 qmake/moc 解析异常 —— 全部改成纯英文路径再试
Kit 配置不是一次性的设置项，它是个动态依赖链：编译器路径变动、Qt 重装、VS 更新，都会让旧 Kit 失效。每次环境变更后，别只刷新界面，务必进 Build & Run → Compilers 手动点击 Scan for compilers，再回到 Kits 重新绑定。
