摘要：Qt5 自 2012 年发布以来，已成为嵌入式系统、桌面应用、车载 HMI 和工业 UI 的首选框架。相较于 Qt4，Qt5 在图形架构、模块划分和现代化支持上实现重大跃迁。本文以 Qt5.15 LTS（长期支持版）为基准，系统梳理其全部官方模块及关键子模块，揭示各组件的功能边界、依赖关系与典型应用场景，为开发者提供权威的架构级参考。

---

引言：Qt5 的架构革命

Qt5 的核心变革在于图形渲染后端的重构与声明式 UI 的崛起。它将传统的 QPainter 渲染路径与基于 OpenGL（或 Vulkan/Direct3D）的Scene Graph分离，同时引入Qt Quick作为新一代 UI 开发范式。此外，模块化程度更高，部分功能被拆分、废弃或重写，形成更清晰、更灵活的生态系统。

本文将按功能域分类，全面解析 Qt5 的模块体系。

---

一、基础核心模块

1. QtCore

• 作用：非 GUI 功能基石，所有 Qt 应用必用。
• 关键子系统：
  • 元对象系统（moc、信号槽、QMetaObject）
  • 容器类（QList, QVector, QHash，支持 C++11 范围 for）
  • 线程（QThread, QtConcurrent::run）
  • 文件 I/O（QFile, QDir, QStandardPaths）
  • 事件循环（QEventLoop, QCoreApplication）
  • 插件系统（QPluginLoader）
  • JSON 支持（QJsonDocument, QJsonObject, QJsonArray）✅（Qt4 无）
  • 正则表达式（QRegularExpression，基于 PCRE2）

注意：Qt5 中 QString 默认使用 UTF-8 编码策略优化（内部仍为 UTF-16，但 I/O 更高效）。

---

2. QtGui

• 作用：窗口系统抽象、输入处理、2D/3D 图形基础。
• 不再包含 Widgets（Qt4 中 QtGui 含按钮、对话框等，Qt5 已拆出）。
• 关键子系统：
  • 窗口管理（QWindow, QScreen, QPlatformWindow）
  • 输入事件（QKeyEvent, QMouseEvent, 触摸/手势 QGesture）
  • 绘图基础（QPainter, QPixmap, QImage, QBrush, QPen）
  • 字体与文本（QFont, QTextLayout）
  • OpenGL 集成（QOpenGLContext, QOpenGLFunctions）
  • 高 DPI 支持（自动缩放、设备像素比 devicePixelRatio()）

重要变化：QtGui 成为 Qt Quick 和 QtWidgets 的共同底层依赖。

---

3. QtWidgets

• 作用：传统桌面控件（按钮、表格、菜单等）。
• 依赖：QtGui + QtCore
• 典型类：
  • 基础控件：QWidget, QPushButton, QLineEdit
  • 布局：QHBoxLayout, QFormLayout
  • 模型/视图：QTableView + QStandardItemModel
  • 对话框：QFileDialog, QMessageBox

适用场景：企业级桌面软件、配置工具、嵌入式控制面板（资源受限时仍优于 Qt Quick）。

---

二、现代 UI 与图形渲染模块

4. QtQuick

• 作用：声明式 UI 框架，基于 QML 语言。
• 核心理念：“UI as Code”，数据驱动、动画友好。
• 关键组件：
  • QQuickItem：所有可视元素基类
  • QQuickView / QQmlApplicationEngine：QML 引擎入口
  • Scene Graph：基于 OpenGL/Vulkan 的高性能渲染管线
  • 内置类型：Rectangle, Text, Image, ListView, Repeater
  • 动画系统：PropertyAnimation, Behavior, Transition

优势：开发效率高、UI 表现力强、天然支持触摸与动效。

---

5. QtQml

• 作用：QML 语言运行时与元对象集成。
• 功能：
  • 解析并执行 .qml 文件
  • 将 C++ QObject 暴露给 QML（qmlRegisterType）
  • 提供 JavaScript 引擎（基于 V4 或旧版 JSC）
• 与 QtQuick 关系：QtQuick 依赖 QtQml，但 QtQml 可独立用于逻辑脚本。

---

6. QtQuick Controls

• 版本演进：
  • Qt Quick Controls 1（Qt5.1+）：模拟桌面控件风格，性能一般。
  • Qt Quick Controls 2（Qt5.7+）：轻量、高性能、专为嵌入式/移动优化。
• 推荐：新项目一律使用 Controls 2。

---

7. QtGraphicalEffects

• 作用：为 Qt Quick 提供视觉特效（模糊、阴影、色彩调整）。
• 注意：部分效果依赖 OpenGL，软件渲染下可能降级或失效。

---

三、多媒体与音视频模块

8. QtMultimedia

• 取代 Phonon，成为 Qt5 官方多媒体方案。
• 功能：
  • 音频播放/录制（QMediaPlayer, QAudioOutput）
  • 摄像头访问（QCamera）
  • 视频输出（VideoOutput QML 类型）
• 后端：Windows（MF/DirectShow）、Linux（GStreamer）、macOS（AVFoundation）

局限：不支持编解码开发，仅提供高层 API。

---

9. QtMultimediaWidgets

• 作用：在 QtWidgets 中嵌入视频播放窗口（QVideoWidget）。
• 依赖：QtMultimedia + QtWidgets

---

四、网络与通信模块

10. QtNetwork

• 增强点（相比 Qt4）：
  • 完善的 QNetworkAccessManager（支持 HTTP/2 实验性）
  • SSL/TLS 更健壮（支持 SNI、证书验证）
  • 新增 QTcpServer::hasPendingConnections()
  • 支持 IPv6 优先
• 新增类：QNetworkConfigurationManager（移动网络管理，Qt5.2+）

---

11. QtWebSockets

• 作用：实现 WebSocket 客户端/服务器。
• 类：QWebSocket, QWebSocketServer
• 典型应用：实时数据推送、IoT 设备通信。

---

12. QtSerialPort

• 作用：跨平台串口通信（RS232/UART）。
• 类：QSerialPort, QSerialPortInfo
• 价值：填补 POSIX/Windows API 差异，广泛用于工控设备。

---

五、数据处理与存储模块

13. QtSql

• 基本延续 Qt4，但增强线程安全。
• 新增：QSqlQuery::execBatch() 批量执行。
• 推荐：SQLite 仍为嵌入式首选；MySQL/PostgreSQL 需插件。

---

14. QtXml

• 保留 DOM/SAX，但新增 QXmlStreamReader/Writer（流式、低内存、推荐使用）。

---

15. QtXmlPatterns

• 作用：XQuery 与 XPath 支持（基于 XQilla 引擎）。
• 使用场景：复杂 XML 数据查询（较少用）。

---

六、图形与可视化高级模块

16. QtOpenGL

• 状态：已废弃（Qt5.4 起标记 deprecated）。
• 替代方案：直接使用 QtGui 中的 QOpenGL* 类（如 QOpenGLWidget）。

---

17. QtCharts

• 作用：2D 数据可视化（折线图、柱状图、饼图等）。
• 形式：Qt5.7+ 作为附加模块（Qt Add-on） 提供。
• 支持：Widgets（QChartView）和 Qt Quick（ChartView QML 类型）。

---

18. QtDataVisualization

• 作用：3D 数据可视化（曲面图、散点图、柱状图）。
• 同样为附加模块，依赖 OpenGL。

---

七、工具与辅助模块

19. QtTest

• 增强：支持 GUI 测试（QTest::mouseClick）、benchmark 测试。

---

20. QtUiTools

• 作用：运行时加载 .ui 文件（QUiLoader），用于动态 UI 构建。

---

21. QtConcurrent

• 作用：高级并发抽象（QtConcurrent::map, filtered, run）。
• 优势：无需手动管理线程，自动利用 CPU 核心。

---

22. QtSvg

• 作用：渲染 SVG 图形（QSvgWidget, QSvgRenderer）。
• Qt Quick 支持：通过 Image 或 Svg QML 类型（需 QtQuick.Controls 2 扩展）。

---

八、平台与系统集成模块

23. QtPlatformHeaders

• 作用：访问平台特定 API（如 Windows HWND、X11 Display）。
• 使用场景：与原生 SDK 交互（如 DirectX 嵌入）。

---

24. QtWayland / QtXcb / QtWindows

• 说明：这些是平台插件，通常不直接链接，由 Qt 运行时自动加载。

---

九、模块依赖关系简图

QtCore  ↑QtGui ← QtOpenGLFunctions, QtEglFSDeviceIntegration (平台插件)  ↗     ↖QtWidgets   QtQuick ← QtQml ← QtQuick.Controls, QtGraphicalEffects  ↑           ↑QtSvg     QtMultimedia ← QtMultimediaWidgets  ↑QtSql, QtXml, QtNetwork, QtSerialPort, QtWebSockets  ↑QtCharts, QtDataVisualization (附加模块)

十、Qt5 vs Qt4 关键升级总结

能力	Qt4	Qt5
UI 范式	仅 Widgets	Widgets + Qt Quick（主推）
图形后端	QPainter → Raster/X11	Scene Graph（GPU 加速）
JSON	无	原生 QJsonDocument
串口	无	QtSerialPort
WebSocket	无	QtWebSockets
高 DPI	基础	自动缩放、完善支持
多媒体	Phonon	QtMultimedia（更统一）

---

结语：构建面向未来的 Qt5 应用

Qt5 通过模块化、现代化和 GPU 加速，成功跨越了从传统桌面到智能嵌入式终端的鸿沟。掌握其模块全景，不仅能高效选型（如“用 Qt Quick Controls 2 而非 Controls 1”），更能规避已废弃组件（如 QtOpenGL），确保项目长期可维护。

迁移建议：

• 新项目优先采用 Qt Quick + Controls 2
• 工控/低资源设备可继续使用 QtWidgets
• 利用 Qt Creator 的模块依赖分析工具自动管理 .pro 或 CMakeLists.txt

尽管 Qt6 已发布，Qt5.15 LTS 仍将持续获得商业支持至 2026 年之后，是当前工业部署的黄金标准。

更多精彩推荐：

Android开发集

青衣霜华渡白鸽，公众号：清荷雅集-墨染优选从 AIDL 到 HIDL：跨语言 Binder 通信的自动化桥接与零拷贝回调优化全栈指南

C/C++编程精选

青衣霜华渡白鸽，公众号：清荷雅集-墨染优选宏之双刃剑：C/C++ 预处理器宏的威力、陷阱与现代化演进全解

开源工场与工具集

青衣霜华渡白鸽，公众号：清荷雅集-墨染优选nlohmann/json：现代 C++ 开发者的 JSON 神器

MCU内核工坊

青衣霜华渡白鸽，公众号：清荷雅集-墨染优选STM32：嵌入式世界的“瑞士军刀”——深度解析意法半导体32位MCU的架构演进、生态优势与全场景应用

拾光札记簿

青衣霜华渡白鸽，公众号：清荷雅集-墨染优选周末遛娃好去处！黄河之巅畅享亲子欢乐时光

数智星河集

青衣霜华渡白鸽，公众号：清荷雅集-墨染优选被算法盯上的岗位：人工智能优先取代的十大职业深度解析与人类突围路径

Docker 容器

青衣霜华渡白鸽，公众号：清荷雅集-墨染优选Docker 原理及使用注意事项（精要版）

linux开发集

青衣霜华渡白鸽，公众号：清荷雅集-墨染优选零拷贝之王：Linux splice() 全面深度解析与高性能实战指南

青衣染霜华

青衣霜华渡白鸽，公众号：清荷雅集-墨染优选脑机接口：从瘫痪患者的“意念行走”到人类智能的下一次跃迁

QT开发记录-专栏

青衣霜华渡白鸽，公众号：清荷雅集-墨染优选Qt 样式表（QSS）终极指南：打造媲美 Web 的精美原生界面

Web/webassembly技术情报局

青衣霜华渡白鸽，公众号：清荷雅集-墨染优选WebAssembly 全栈透视：从应用开发到底层执行的完整技术链路与核心原理深度解析

数据库开发

青衣霜华渡白鸽，公众号：清荷雅集-墨染优选ARM Linux 下 SQLite3 数据库使用全方位指南