“No valid kits found”是Qt Creator未正确配置Kit所致，需手动关联编译器、Qt版本（qmake路径）和调试器三要素，并确保架构匹配、路径无中文空格。
Qt Creator启动后提示“No valid kits found”怎么办
这是最常见、也最容易卡住新手的第一步。不是没装好，而是 Qt Creator 没法自动把编译器、Qt 版本、调试器三者串起来形成一个可用的 Kit。
关键动作是手动补全三要素：
- 确认已安装 MinGW（Windows）或 Clang（macOS）或 GCC（Linux），且路径不含中文、空格、特殊字符
- 在
Tools > Options > Kits > Compilers中点击“Add”，选择对应编译器可执行文件：g++.exe（MinGW）、clang++（macOS）、g++（Linux） - 在
Kits > Qt Versions页签中点击“Add”，指向你安装的 Qt 的qmake路径，例如：C:\Qt\6.5.0\mingw_64\bin\qmake.exe或/opt/homebrew/opt/qt/bin/qmake - 回到
Kits页签，点击“Add”，填入名称（如Desktop Qt 6.5.0 MinGW 64-bit），然后分别下拉选择刚配好的编译器和 Qt 版本
注意：macOS 上若用 Homebrew 安装 Qt，qmake 默认在 /opt/homebrew/opt/qt/bin/qmake；M1/M2 芯片用户别误选 x86_64 版本的工具链。
为什么新建项目时选不到 Qt Widgets Application 模板
模板缺失通常不是 IDE 问题，而是 Qt 安装时漏选了核心模块。
Windows 用户检查安装器里是否勾选了：Qt 6.5.0 (MinGW 11.2.0 64-bit) 下的 Widgets 组件；macOS 用 Homebrew 安装时，默认不带 Widgets 模块，需额外运行：brew install qt@6（Homebrew 的 qt 元包已含 Widgets）。
Linux 用户若用系统包管理器安装，要确保装了 qt6-base-dev 和 qt6-widgets-dev（Ubuntu/Debian）或对应开发包。
如果已安装但模板仍不显示，重启 Qt Creator 后，在 Help > About Plugins 中确认 QtSupport 和 Designer 插件处于启用状态。
Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
main.cpp 编译报错 “undefined reference to `WinMain'”
这是 Windows 下典型的子系统链接错误，说明链接器被当成 GUI 程序处理，但入口函数仍是 C 风格的 main()。
根本原因是项目类型与构建配置不匹配：
- 如果你创建的是
Qt Widgets Application，它默认生成QApplication实例，入口必须是int main(int argc, char *argv[])，且不能删掉#include <qapplication></qapplication> - 如果误选了
Console Application模板却想跑 GUI，会缺 Qt Widgets 依赖，也会触发类似报错 - 检查
.pro文件里是否有CONFIG += console—— 这行必须删掉，否则强制启用控制台子系统，与QApplication冲突
临时验证：把 main.cpp 中的 QApplication a(argc, argv); 改成 QGuiApplication a(argc, argv); 并删掉 widget.show()，能编译通过但无窗口 —— 这说明 Kit 和 Qt 版本本身没问题，问题纯属项目配置错位。
Qt Creator 找不到 qmake 或 moc，命令行却可用
说明环境变量生效范围不一致：终端 shell 里设置了 PATH，但 Qt Creator 是从桌面环境启动的，没继承 shell 的 PATH。
Windows 上最稳妥的做法是：在 Tools > Options > Environment > System 中，勾选 Change system environment variables，然后手动添加 Qt 的 bin 目录到 PATH，例如：C:\Qt\6.5.0\mingw_64\bin。
macOS/Linux 用户不要依赖 ~/.zshrc 里的 export PATH —— Qt Creator 启动时并不读取它。正确做法是在 Tools > Options > Environment > System 的 Environment 区域点击 Add，新增变量：PATH，值设为完整路径，例如：/opt/homebrew/opt/qt/bin:/usr/bin:/bin。
改完记得重启 Qt Creator，否则缓存的旧 PATH 仍生效。
