Qt Widgets Application是Windows和Linux上最稳妥的入门选择，创建时项目路径和名称必须为纯英文、无空格无中文，Kit需手动确认MinGW已启用，且main.cpp中必须包含QApplication、主窗口实例化、show()及a.exec()事件循环。

Qt Widgets Application 是 Windows 和 Linux 上最稳妥的入门选择，能直接跑出带窗口的 GUI 程序，不用额外配 QML 或 Python 环境。

创建项目时路径和名称不能含中文或空格

这是 Qt Creator 最常报错的源头。比如 D:\我的项目\hello 或 C:\Qt Projects\test app 都会卡在 qmake 生成阶段，错误信息通常是：Error: Cannot create directory 或 Project ERROR: Unknown module(s) in QT: widgets。
正确做法是用纯英文路径，例如：D:\qt_projects\hello_world，项目名也别用下划线或数字开头，HelloWorld 就比 1st_app 更可靠。

Kit（编译套件）没自动选中就手动指定 MinGW

安装完 Qt Online Installer 后，MinGW 7.3.0 64-bit 或 MinGW 11.2.0 64-bit 应该已存在，但 Qt Creator 有时不会默认勾选它。如果点击“完成”后构建按钮灰掉、或提示 No valid kits found，说明 Kit 没配好。
解决方法：
• 点击左下角 Projects 模式（或按 Ctrl+5）
• 在 Build & Run → Kits 里检查是否有带绿色对勾的 Kit
• 如果没有，点 Add，选 Desktop Qt x.x.x MinGW x-bit，再把 Compiler 和 Debugger 补全（通常自动识别）
• 回到项目向导重新走一遍，或直接在已有项目里右键 Reconfigure project

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

第一次运行前先确认 main.cpp 调用了 QApplication

Qt Widgets 项目默认生成的 main.cpp 是标准模板，但如果你误删或改写过，可能启动失败，现象是程序一闪而退，控制台无输出。
必须确保 main.cpp 包含以下三要素：
• #include <QApplication>
• #include "widget.h"（或你实际的主窗口类头文件）
• QApplication a(argc, argv); + Widget w; + w.show(); + return a.exec();
漏掉 a.exec() 就不会进入事件循环，窗口自然打不开。

Qt Creator 的项目创建流程本身很轻量，真正卡住人的地方几乎都落在路径、Kit 和入口函数这三点上。只要避开中文路径、确认 MinGW Kit 可用、不碰 main.cpp 的核心结构，第一个窗口几秒就能弹出来。