能正常创建并运行空的 widgets application 项目才说明 qt creator 安装成功；需先检查 kits 是否就绪，确保编译器、qt 版本、调试器三者齐全且无红色警告，再通过新建并运行最小 widgets 项目闭环验证。
能正常创建并运行一个空的 Widgets Application 项目，就说明 Qt Creator 安装成功了。 光是图标能点开、界面能加载，不等于环境可用——很多用户卡在“启动了但编译报错”“新建项目后灰色不可构建”，其实是 Kit 配置缺失或错位。
打开 Qt Creator 后第一件事：检查 Kits 是否就绪
Kit 是 Qt Creator 能否真正构建项目的最小工作单元，它必须同时包含三样东西：编译器、Qt 版本、调试器。缺一不可。
- 按
Ctrl+5（Windows/Linux）或Cmd+5（macOS）快速进入「项目」设置页，切换到「构建和运行」→「Kits」标签 - 看列表里是否有带绿色对勾、且无红色感叹号的条目，例如：
Desktop Qt 6.5.3 MinGW 64bit或Desktop Qt 5.15.2 GCC 64bit - 如果为空或全是红色警告，说明 Kit 没自动识别成功，不能跳过这步直接建项目
验证 Qt 版本和编译器是否被正确识别
Kit 依赖底层组件，Kit 灰掉往往是因为 Qt 版本 或 编译器 根本没注册进系统。
- 在「构建和运行」→「Qt 版本」页，确认
qmake路径可访问（例如/opt/Qt6.5.3/bin/qmake或C:\Qt\6.5.3\mingw_64\bin\qmake.exe） - 在「编译器」页，确认
gcc/g++（Linux）、clang（macOS）、MinGW-w64或MSVC（Windows）路径存在且可执行 - Linux/macOS 下常见权限问题：
chmod +x /path/to/qmake，否则 Qt Creator 会静默忽略该版本 - Windows 上若选了 MSVC 但没装对应 Visual Studio，Kit 会显示“Debugger not found”，需手动指定
vs2019 x64 Native Tools Command Prompt环境或改用 MinGW
创建并运行一个最小 Widgets Application
这是唯一能闭环验证的实操动作。模板项目不依赖业务逻辑，只测工具链连通性。
- 「文件」→「新建文件或项目」→「Application」→「Qt Widgets Application」→ 一路默认下一步
- 在最后一步「Kit 选择」界面，务必勾选你刚确认过的那个有效 Kit（比如
Desktop Qt 6.5.3 MinGW 64bit），不要留空或选「Auto-detected」 - 点击「完成」后，等待左下角状态栏显示「项目已解析」，再点左下角绿色三角形「运行」按钮
- 如果弹出空白窗口并标题为「Widget」，控制台输出类似
Starting /path/to/project/build-xxx/Widget...，即成功 - 若报错
Cannot find -lGL（Linux）、debugger not found（Windows）、或构建日志里出现qmake: could not exec '/usr/lib/qt5/bin/qmake'，说明 Kit 中某环节断了，得回前两步查
Kit 配置不是一次性的——换 Qt 版本、重装系统、甚至升级 macOS 后的 Xcode 命令行工具，都可能让原有 Kit 失效。每次重启 Qt Creator 后扫一眼 Kits 页面，比等编译失败再排查快得多。
