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>}• 确保 Kit 正确,直接点 ▶️ 运行
• 成功弹窗,说明环境通了;失败则问题一定出在 Kit 或基础路径上,不用往下看 UI 设计 Kit 配置这一步没法跳过,也没法靠“再试一次”解决。它不报语法错误,但会让后续所有操作失效——比如你花半小时拖好按钮、连好信号,最后发现
connect() 根本没生效,大概率是 Kit 里的 Qt 版本压根没包含 widgets 模块。

















