Ubuntu 22.04 解决 Qt 报错：Unknown module (s) in QT: qml quick

sudo apt install qt5-*
sudo apt install qml
sudo apt-get install qtdeclarative5-dev

解决 Qt 报错：Unknown module (s) in QT: qml quick

这个错误的核心原因是：你的 Qt 环境没有安装 QML 和 Quick 相关的模块，Qt 构建项目时找不到依赖，直接报错。

QT += qml quick 是 Qt Quick 项目的核心依赖，专门用于开发 QML 界面，缺失模块就会触发这个错误。

---

一、最常见的解决方法（90% 的情况）

1. 打开 Qt 维护工具

找到你的 Qt 安装目录，运行 MaintenanceTool.exe（Windows），Mac/Linux 直接搜索这个工具名。

2. 进入组件安装界面

1. 选择 Add or remove components（添加或移除组件）
2. 展开你正在使用的 Qt 版本（比如 Qt 6.7 / Qt 5.15）
3. 勾选 必装模块 ：
   • Qt Quick
   • Qt QML
   • 额外建议勾选：Qt Quick Controls 2（常用界面控件）

3. 点击安装，等待完成

安装后重启 Qt Creator，重新构建项目即可。

---

二、其他 3 种可能的原因 & 解决方案

1. 项目用错了 Qt 版本（ Kits 不匹配）

Qt Creator 可能默认选中了没有安装 QML 模块的 Qt 版本：

• 左侧「项目」→ 构建套件（Kit）
• 确认当前使用的 Qt 版本，是你刚才安装了 QML/Quick 模块的版本
• 切换到正确的 Kit，重新构建

2. Qt 6 和 Qt 5 模块写法差异（版本兼容问题）

• Qt 6 ：必须写

  qmake

  QT += qml quick

• Qt 5 ：部分旧版本可以简写（但推荐完整写）

  qmake

  QT += quick

3. Linux 系统（apt 安装的 Qt）

如果是 Ubuntu/Debian 用 apt 安装的 Qt，直接执行命令安装模块：

# Qt 5
sudo apt-get install qtdeclarative5-dev

# Qt 6
sudo apt-get install qt6-declarative-dev

---

三、快速验证是否修复成功

1. 打开你的 .pro 项目文件，确认有这行代码：

   qmake

   QT += qml quick

2. 点击 清理项目 → 重新运行 qmake → 构建项目

3. 没有报错，就是修复完成了

---

总结

1. 核心原因：未安装 Qt QML/Quick 模块
2. 解决步骤：打开维护工具 → 勾选对应模块 → 安装 → 重启 Qt Creator
3. 额外检查：构建套件是否选对、Qt 版本写法是否正确