1. 课程导入
在嵌入式与桌面/移动端图形界面开发中，LVGL 与 Qt 是两条极具代表性的技术路线。LVGL 以轻量、低资源占用、纯 C 实现著称，常见于 MCU、RTOS 和资源受限的嵌入式设备；Qt 则以跨平台、面向对象、组件丰富、工具链成熟见长，广泛应用于工业 HMI、车载中控、医疗设备与桌面应用。把已有 LVGL 界面迁移到 Qt，并不是“把 C 代码翻译成 C++”这么简单，而是一次涉及架构、事件模型、渲染机制、资源管理与工程组织的系统性重构。
一、定位差异：不是替代，而是换赛道
理解两者差异，是迁移工程的第一步。LVGL 的定位是“为资源受限设备提供最小可用的图形库”，它把控件、样式、动画、输入设备抽象成一套 C 语言 API，开发者通常直接操作对象指针，手动管理生命周期。Qt 的定位是“完整的应用开发框架”，它提供 QWidget 与 QML 两套 UI 体系，配合信号槽、元对象系统、模型视图、国际化、网络与数据库模块，强调可扩展性与工程化。
从渲染角度看，LVGL 多采用直接绘制到帧缓冲或通过显示驱动刷新，控件层级与重绘区域由库内部管理；Qt 则通过 QPainter、场景图或 GPU 加速完成合成，窗口系统负责裁剪与合成。从事件模型看，LVGL 使用回调函数与事件码，Qt 使用信号槽与事件过滤器，二者在“谁通知谁、何时通知”上存在根本差异。
| 对比维度 | LVGL | Qt |
|---|---|---|
| 语言与范式 | C，面向过程，手动管理对象 | C++/QML，面向对象，父子对象树自动管理 |
| 资源占用 | 极低，适合 MCU/RTOS | 较高，适合 Linux/Windows/Android 等 |
| 事件机制 | 回调函数 + 事件码 | 信号槽 + 事件过滤器 |
| UI 构建方式 | 代码创建控件与样式 | Designer/.ui、QML 或纯代码 |
| 布局系统 | flex/grid 基础布局 | QLayout、锚点、QML 布局器 |
| 典型场景 | 智能家居面板、穿戴设备 | 工业 HMI、车载、医疗、桌面工具 |
二、迁移工程的整体目标
迁移不是“重写一遍”，而是“在保留业务价值的前提下，把界面与交互迁移到更可持续的框架上”。整体目标可以拆成四个层次：
- 功能等价：原有页面的按钮、列表、图表、弹窗、状态提示等交互行为在 Qt 中可复现。
- 视觉一致：颜色、字体、圆角、间距、动效节奏尽量贴近原设计，必要时借助 Qt 样式表或 QML 主题统一管理。
- 架构可维护：把 LVGL 中散落在回调里的业务逻辑，重构为 Qt 的信号槽、模型视图或独立服务类。
- 工程可交付：形成 CMake/qmake 工程、资源文件、翻译文件、构建脚本与基础测试，能持续集成。
三、学习路径：从认知到交付的五个阶段
本课程按 30 个章节推进，整体学习路径可归纳为五个阶段。第一阶段建立认知：理解 LVGL 与 Qt 的定位差异、迁移边界与交付标准。第二阶段打基础：掌握 Qt 对象树、信号槽、事件循环、布局与样式表。第三阶段做映射：把 LVGL 控件、样式、动画、输入事件逐一映射到 Qt 对应机制。第四阶段做工程：引入模型视图、资源管理、国际化、多页面导航与状态管理。第五阶段做交付：完成构建、调试、性能优化与迁移复盘。
四、最终交付物清单
迁移工程结束时，交付物不应只是“能跑的界面”，而应是一套可复用的工程资产。建议按以下清单验收：
- Qt 工程源码：包含 CMakeLists.txt 或 .pro 文件，目录结构清晰，区分 UI、业务、资源与测试。
- 界面资源：图片、字体、图标、QSS 样式表或 QML 主题文件，统一放入资源系统。
- 迁移映射表：记录每个 LVGL 控件/事件对应的 Qt 实现，便于后续维护与二次迁移。
- 构建与运行说明：包含依赖版本、编译命令、目标平台与常见问题。
- 基础测试：至少覆盖关键页面加载、按钮点击、列表滚动与状态切换。
# 典型 Qt 工程构建命令示例
cmake -S . -B build -DCMAKE_PREFIX_PATH=/opt/Qt/6.6.0/gcc_64
cmake --build build -j8
./build/lvgl2qt_demo
五、常见误区与复盘建议
误区二：只关注控件外观，忽略事件链路与数据流，出现“界面像了但交互不对”。
误区三：一次性重写全部页面，缺少可运行的最小闭环，问题定位困难。
误区四：忽略资源路径与平台差异，在开发机正常、目标板崩溃。
复盘时建议回答三个问题：哪些 LVGL 逻辑可以原样保留为纯 C/C++ 业务层？哪些必须改为 Qt 模型或服务？哪些视觉细节值得用 QSS/QML 统一抽象？把答案沉淀为迁移规范，后续页面就能按同一套模式快速推进。