qt creator 入门第一步是验证 kit 配置是否可用：检查 kits 页面中 compiler、qt version、debugger 三列均有有效值且带绿色对勾，任一为灰色或“none”则 kit 不可用，需手动修正路径、abi 匹配及环境变量。
Qt Creator 入门第一步不是写代码，而是确认 Kit 配置是否真正可用——很多新手卡在“点击运行却没反应”或“报错 cannot find -lqt5core”，本质是 Kit 没配对，不是代码写错了。
Kit 为什么必须手动核对？
安装 Qt 时勾选了 MinGW 和 Qt 版本，不代表 Qt Creator 就自动把它们串起来了。它会尝试自动检测，但常见失败场景包括：
• MinGW 的 bin 目录没加进系统 PATH（尤其重装过系统或用绿色版 Qt）
• 安装路径含中文或空格（如 C:\Program Files\Qt 或 D:\我的Qt），导致工具链路径解析失败
• Qt 版本和编译器 ABI 不匹配（比如用 MinGW 11.2 去配 Qt 5.15.2 (MSVC2019)）
怎么验证 Kit 是否就绪？
打开 Qt Creator → 工具 → 选项 → 构建和运行 → Kits，检查列表里有没有带绿色对勾的项。重点看三列：
• Compiler：应显示类似 MinGW 11.2.0 (x86_64)，且状态为“已检测”
• Qt version：应指向一个有效的 Qt 5.15.2 或 Qt 6.5.3 路径，点开右边小箭头能展开版本号和 qmake 路径
• Debugger：通常自动关联，但若为空，可手动指定 gdb.exe（在 MinGW 安装目录下的 bin 子目录里）
如果任一列是灰色或显示“None”，这个 Kit 就不能用，强行新建项目只会生成一堆构建错误。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
创建项目时别跳过 Kit 选择
新建项目后，在向导最后一步（“Kit Selection” 页面）务必手动勾选那个带绿色对勾的 Kit，而不是依赖默认值。常见陷阱：
• 机器上装了多个 Qt 版本（比如 Qt 5 和 Qt 6），默认可能选错
• 同一 Qt 版本配了两套编译器（MinGW 和 MSVC），但只有一套调试器正常
• 项目类型选了 Qt Widgets Application，却用了 Qt Quick Application 对应的 Kit（二者模块依赖不同）
选错 Kit 的典型症状是：项目能创建，但 main.cpp 里 #include <qapplication></qapplication> 报红，或者构建时报 Unknown module(s) in QT: widgets。
第一个可运行程序要避开 UI 文件陷阱
新手常从双击 mainwindow.ui 开始折腾布局，结果发现信号槽连不上、ui->xxx 提示未声明。更稳妥的第一步是绕过 UI 文件，直接改 main.cpp：
• 新建 Qt Widgets Application 项目
• 打开 main.cpp，删掉原有内容，替换成最简版本：
#include <qapplication><br>#include <qlabel><br><br>int main(int argc, char *argv[]) {<br> QApplication app(argc, argv);<br> QLabel label("OK, Qt Creator is working.");<br> label.show();<br> return app.exec();<br>}</qlabel></qapplication>
• 确保 Kit 正确，直接点 ▶️ 运行
• 成功弹窗，说明环境通了；失败则问题一定出在 Kit 或基础路径上，不用往下看 UI 设计 Kit 配置这一步没法跳过，也没法靠“再试一次”解决。它不报语法错误，但会让后续所有操作失效——比如你花半小时拖好按钮、连好信号，最后发现
connect() 根本没生效，大概率是 Kit 里的 Qt 版本压根没包含 widgets 模块。
