应直接选择Qt Widgets Application模板，它生成标准C++与.ui文件组合结构，编译后弹出原生窗口，可立即验证开发环境是否正常。
Qt Widgets Application模板选哪个
直接选 Qt Widgets Application，别碰 Qt Quick Application 或 Qt Console Application。前者依赖 QML 运行时，新手容易卡在 qrc 资源加载或 QQuickView 初始化失败；后者没窗口、不显示 UI，根本看不出“第一个项目”跑没跑起来。
这个模板生成的是标准 C++ + .ui 文件的组合结构，编译后弹出原生窗口，能立刻验证环境是否通——这是你当前最需要的反馈。
项目路径和名称不能含中文或空格
路径里出现中文、空格、括号（比如 C:\Users\张三\Documents\My Qt Projects）会导致 qmake 解析 .pro 文件失败，报错类似：Project ERROR: Unknown module(s) in QT: widgets 或直接卡在“正在运行 qmake…”不动。
实操建议：
- 新建一个纯英文路径，例如
D:\qt-projects\helloqt或/Users/you/qt-projects/helloqt - 项目名称用小写字母+下划线，如
helloqt、my_first_app，别用HelloQt!或test-1 - Mac 用户特别注意：如果用 Homebrew 安装 Qt，确保
PATH已包含/opt/homebrew/opt/qt/bin，否则创建完项目点运行会提示qmake not found
Kit 选择必须匹配已安装的 Qt 版本和编译器
点击 “Next” 后的套件（Kit）页面，看到的列表不是“随便选一个就行”。它必须同时满足两个条件：对应已安装的 Qt 版本（如 Qt 6.5.0）、且绑定可用的编译器（如 MinGW 11.2 或 MSVC 2019）。常见错误是勾选了灰色不可用的 Kit，表面能继续，但构建时会卡在 Running CMake... 或直接报 No valid kits found。
Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
检查方法：
- 菜单栏 →
Tools→Options→Kits，确认Compilers和Qt Versions都有有效条目 - Windows 上若只装了 MSVC，就别选 MinGW Kit；反之亦然
- Mac 上若用 Homebrew 装 Qt，
Qt version路径应为/opt/homebrew/Cellar/qt/6.5.0/lib/cmake/Qt6类似结构，不是/usr/local/...
创建后第一件事不是写代码，而是点构建按钮
项目点“Finish”只是生成文件，不代表环境就绪。必须立刻按 Ctrl+B（或点击左下角锤子图标）执行一次构建，观察 Compile Output 窗格里有没有报错。
关键信号：
- 看到
Running /path/to/qmake ...→Running /path/to/make ...→ 最后一行是Build finished：说明基础链路通了 - 如果卡在
qmake: could not find a Qt installation of ''：Kit 配置错，回上一步重选 - 如果报
undefined reference to `WinMain'（Windows）：可能误选了 Console 模板，删项目重来
这一步跳过，后面改界面、连信号槽时出问题，你很难分清是逻辑错还是环境没搭好。
