Ubuntu下仅装qtcreator和qt5-default不够，必须补充qt5-qmake、build-essential、qtdeclarative5-dev等组件才能解决Kit为空、QML模块缺失等问题。
直接装 qtcreator 和 qt5-default 就能跑起来，但缺了关键组件会卡在“找不到 Qt 版本”或“Kit 为空”，不是装完就能用。
Ubuntu/Debian 系统：apt 安装必须带这组依赖
只执行 sudo apt install qtcreator 是不够的——它不会自动拉取 Qt 库、qmake 或 QML 支持。真正能开箱即用的命令是：
sudo apt updatesudo apt install -y qtcreator qt5-default qt5-qmake g++ build-essentialsudo apt install -y qtdeclarative5-dev qttools5-dev qttools5-dev-tools libqt5svg5-dev
其中 qt5-default 提供系统级默认 Qt5 路径（/usr/lib/x86_64-linux-gnu/qt5），qt5-qmake 是构建系统必需的二进制；漏掉 qtdeclarative5-dev，新建 QML 项目时会报错 “QML module not found”；libqt5svg5-dev 缺失则 Designer 里拖 SVG 图标会崩溃。
Qt Creator 启动后 Kit 为空？检查 qmake 路径是否被识别
安装完打开 Qt Creator，进入 Tools → Options → Kits → Qt Versions，常见问题：
- 列表为空 → 说明
qt5-qmake没装，或路径没被自动扫描到；手动点+，添加/usr/lib/x86_64-linux-gnu/qt5/bin/qmake（Ubuntu/Debian 默认位置） - 有 qmake 但 Kit 里编译器显示 “None” → 检查
g++是否可用：g++ --version；若提示未找到，补装build-essential - Kit 名称显示 “Desktop Qt 5.x.x GCC” 却标红 → 右侧 Compiler 下拉框可能为空，需先在 Compilers 页签确认
g++已被识别（路径通常为/usr/bin/g++）
Windows 上用在线安装器，别选错 MinGW 版本
从 https://download.qt.io/archive/qt/ 下载 qt-opensource-windows-x86-5.15.2.exe 这类安装包时，注意组件勾选：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 必须勾选对应 Qt5 版本（如
5.15.2）下的MinGW 11.2 64-bit（不是MinGW 10.2或MSVC，除非你装了 Visual Studio） - Qt Creator 组件建议勾选，避免后续还要单独装 IDE
- 跳过
Source和Examples可省下 2GB 空间，不影响日常开发
装完首次启动，Options → Kits 里应自动识别出一个 Kit，名称含 “Desktop Qt 5.15.2 MinGW 11.2 64-bit”。如果没出现，重启 Qt Creator 再试一次——在线安装器有时需要二次扫描。
统信 UOS 用户：软件商店安装后仍要补命令行组件
通过应用中心装的 Qt Creator 界面干净，但常缺 QML 调试和 UI 设计能力。装完立刻执行：
sudo apt install -y qtdeclarative5-dev qttools5-dev-tools- 然后在 Qt Creator 中打开 Help → About Plugins，确认
QmlDesigner和QmlProfiler已启用 - 若新建项目时提示 “
qmlscene: command not found”，补装：sudo apt install -y qmlscene
UOS 的 APT 源偶尔滞后，如果 qt5-default 版本低于 5.12，建议改用在线安装器装 Qt5.15.2 + 独立 Qt Creator，否则 Designer 加载 .ui 文件会卡死。
Qt5 和 Qt6 共存时，Qt Creator 不会自动把旧项目迁移到新 Kit，每个项目得手动在 Projects → Build & Run → Kits 里指定 Qt5 对应的 Kit，这点容易忽略。
