结论：新手优先用 qt online installer，别下离线包；必须选带 mingw 或 msvc 的完整组件，登录 qt 账号、避开中文路径、勾选 qt creator、qt 版本、examples 和 documentation，新建项目首选 qt widgets application 模板并设为 debug 构建。
Windows 下装 Qt Creator，到底该选在线安装器还是离线包
直接说结论：新手优先用 Qt Online Installer，别下离线包。离线包体积大（动辄 5–7 GB），且版本固定、无法按需勾选组件；在线安装器能自动匹配最新稳定版（如 Qt 6.8 或 Qt 5.15.2 LTS），还能后续增量更新 Qt 版本和文档。
常见错误是下载了「Qt Creator only」的精简包——它不带编译器和 Qt 库，启动后新建项目会报 Kit is not valid 或 No valid kits found。必须选带 MinGW（Windows）或 MSVC（需先装 Visual Studio）的完整组件。
- 安装时登录 Qt 账号是强制步骤，没账号就用邮箱注册，跳过会卡在组件选择页
- 安装路径严禁含中文、空格、特殊符号，否则 qmake 生成的 Makefile 会出错
- 勾选时至少保留：
Qt Creator、MinGW 11.2（推荐）、Qt 6.8（或Qt 5.15LTS）、Examples和Documentation
Linux（Ubuntu）用 apt 装 Qt Creator，为什么运行不了 Qt 项目
sudo apt install qtcreator qt5-default 确实能装上 IDE，但只提供 Qt 5 基础运行时，缺编译工具链和 Qt 6 支持。你新建 Qt Widgets Application 项目后，构建时大概率报错：Could not find qmake in PATH 或 The selected kit is not valid。
根本原因是 qt5-default 不等于完整开发环境——它没装 build-essential、libgl1-mesa-dev，也没把 qmake 加入系统 PATH。更麻烦的是，Ubuntu 官方源的 Qt 版本往往滞后（比如仍为 5.12），而新项目常需 5.15+ 或 Qt 6.x。
- 补全依赖：
sudo apt install build-essential libgl1-mesa-dev libxcb-xinerama0 - 手动加
qmake到 PATH：查到实际路径（如/usr/lib/x86_64-linux-gnu/qt5/bin/qmake），再export PATH="/usr/lib/x86_64-linux-gnu/qt5/bin:$PATH" - 真正省事的做法：改用 Qt 官方在线安装器，它自带 Qt 6.8 + CMake 工具链，不依赖系统包管理器
新建项目时选错模板，导致界面打不开或编译失败
初学者最容易卡在第一步：点 New Project → 模板列表里看到一堆选项，随手选了 Qt Quick Application，结果运行后只弹个空白窗口，或者报 QML module not found。这不是代码写错了，是模板和构建配置不匹配。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
真实场景中，Qt Widgets Application 是最稳妥的入门选择。它生成 .ui 文件（XML 格式）、widget.h/cpp 和 main.cpp，所有逻辑用纯 C++ 写，调试直观，兼容性最好。而 Qt Quick 依赖 QML 引擎和 OpenGL 上下文，在某些虚拟机或老旧显卡上会直接崩溃。
- 确认模板右下角显示「C++」而非「QML」，且项目向导里「Build system」选
CMake（Qt 6 默认）或qmake（Qt 5 兼容） - 如果误选了
Empty qmake Project，它不生成任何 UI 文件，需要手动添加FORMS和HEADERS到.pro文件，极易漏配 - 选完模板后务必检查「Kit」下拉框是否已自动识别出 MinGW 或 MSVC，灰色不可选说明编译器没被正确注册
第一次点击 Run，程序闪退或报错 no debug info
不是代码有问题，而是 Qt Creator 默认用 Release 模式构建，关掉了调试符号，导致断点无效、错误堆栈不全。更隐蔽的问题是：Windows 下若没装 Visual C++ 运行库（vc_redist.x64.exe），Release 版程序直接黑窗退出，连错误提示都不显示。
解决的关键是切换构建配置并验证依赖。Qt Creator 右下角状态栏有「Debug」/「Release」切换按钮，旁边还有「MinGW」或「MSVC」的 Kit 名称——这两项必须同时有效才能运行。
- 首次运行前，先点左下角
Projects→ 选中当前 Kit → 把Build configuration改成Debug - Windows 用户额外检查：
Control Panel → Programs and Features中是否存在Microsoft Visual C++ 2015–2022 Redistributable，没有就去微软官网下对应位数的安装包 - Linux 下若提示
libxcb-cursor.so.0: cannot open shared object file，执行sudo apt install libxcb-cursor0补依赖
真正麻烦的从来不是装软件，而是装完之后 Kit 没注册、qmake 找不到、运行库缺失这三件事凑一块儿——它们不会明说“你少装了什么”，只会让你对着黑窗或报错码干瞪眼。
