2. LVGL核心概念回顾

从 LVGL 迁移到 Qt，最容易踩的坑不是 API 名字记不住，而是把 LVGL 的“对象树 + 样式 + 事件 + 定时刷新”心智模型直接套到 Qt 上。Qt 的 QWidget/QML 体系虽然也有父子对象、样式表、信号槽和事件循环，但它们的生命周期、绘制时机、布局约束和动画驱动方式与 LVGL 有本质差异。本节先把 LVGL 的七个核心概念串成一条完整的“从创建到上屏”的链路，为后续逐项映射到 Qt 打基础。

一、对象树：一切界面元素的根

LVGL 中所有可见元素都是 lv_obj_t 对象，按钮、标签、滑块、图表、甚至屏幕本身都是对象。对象通过父子关系组成一棵树：父对象负责裁剪、坐标偏移和生命周期管理，子对象随父对象删除而删除。屏幕（lv_scr_act()）是当前活动树的根，切换屏幕本质上是切换根对象。

对象树带来两个关键行为：一是坐标是相对父对象的，移动父对象会带动所有子对象；二是样式和事件会沿树向上冒泡或向下继承。迁移到 Qt 时，QObject 的 parent-child 机制与它高度相似，但 Qt 的 QWidget 父子关系还额外承担了布局管理和窗口层级职责，不能简单等同。

二、样式：状态驱动的属性集合

LVGL 的样式不是“给对象设一组固定属性”，而是“给对象在不同状态下绑定不同属性”。一个 lv_style_t 可以包含背景色、边框、圆角、阴影、文字字体、内边距等，并且可以针对 LV_STATE_DEFAULT、LV_STATE_PRESSED、LV_STATE_CHECKED、LV_STATE_DISABLED 等状态分别设置。对象可以叠加多个样式，后添加的样式优先级更高，局部样式覆盖全局主题。

static lv_style_t style_btn;
lv_style_init(&style_btn);
lv_style_set_bg_color(&style_btn, lv_color_hex(0x2196F3));
lv_style_set_radius(&style_btn, 8);
lv_style_set_bg_color(&style_btn, lv_color_hex(0x1976D2));
lv_obj_add_style(btn, &style_btn, LV_STATE_DEFAULT);
lv_obj_add_style(btn, &style_btn, LV_STATE_PRESSED);

这种“样式 + 状态”的模型在 Qt 中对应 QSS 的伪状态（:hover、:pressed、:disabled），但 Qt 的样式表作用域、继承规则和绘制管线与 LVGL 不同，尤其是自定义绘制控件时，QSS 往往无法完全覆盖，需要重写 paintEvent。

三、事件、布局、动画、定时器与渲染机制

事件系统方面，LVGL 通过 lv_obj_add_event_cb() 给对象绑定回调，事件类型包括点击、长按、值改变、绘制、删除等。事件默认从触发对象向上冒泡，父对象可以拦截。Qt 则使用信号槽 + 事件过滤器 + event() 虚函数三层机制，信号槽是对象间解耦通信，事件是系统级输入分发，两者不能混用同一套思维。

布局方面，LVGL 提供 Flex 和 Grid 两种布局，通过 lv_obj_set_flex_flow()、lv_obj_set_grid_dsc_array() 等 API 设置，布局计算发生在对象尺寸变化或子对象增删时。Qt 的 QLayout 体系更成熟，支持嵌套布局、尺寸策略和拉伸因子，但 QWidget 的布局是“管理器”模式，而 LVGL 的布局是“对象属性”模式。

动画与定时器是 LVGL 的强项：lv_anim_t 可以驱动任意数值属性，配合 lv_timer_t 实现周期性任务。LVGL 的主循环 lv_timer_handler() 必须被周期性调用，它负责处理定时器、动画、刷新和输入。Qt 则把这一切封装进 QEventLoop，动画由 QPropertyAnimation/QML Animation 驱动，定时器由 QTimer 管理，开发者不需要手动调用“心跳函数”。

渲染机制上，LVGL 采用“脏矩形 + 双缓冲”策略：只有发生变化的区域才会重绘，绘制结果先写入缓冲区，再通过 flush_cb 提交到显示驱动。Qt 的 QWidget 使用 backing store + 合成器，QML 使用场景图（Scene Graph）和 GPU 加速，绘制时机由 update() 请求和事件循环合并决定。

四、案例场景：一个带按压反馈的按钮

在 LVGL 中实现一个带按压反馈的按钮，典型流程是：创建按钮对象 → 添加默认样式和按下样式 → 绑定点击事件回调 → 在回调中切换标签文字或触发业务逻辑。整个过程中，样式负责视觉，事件负责交互，动画负责过渡，定时器负责延时或轮询，渲染机制负责把变化区域刷到屏幕。

lv_obj_t *btn = lv_btn_create(lv_scr_act());
lv_obj_set_size(btn, 120, 48);
lv_obj_align(btn, LV_ALIGN_CENTER, 0, 0);

lv_obj_t *label = lv_label_create(btn);
lv_label_set_text(label, "Start");
lv_obj_center(label);

lv_obj_add_event_cb(btn, btn_event_cb, LV_EVENT_CLICKED, NULL);

迁移到 Qt 后，同样的按钮会变成 QPushButton + QSS 伪状态 + connect(btn, &QPushButton::clicked, ...)。表面看是一一对应，但 Qt 的按钮绘制由 QStyle 接管，QSS 只影响部分属性；如果要做完全自定义的按压动画，往往需要继承 QPushButton 并重写 paintEvent，或者改用 QML 的 Button + State + Transition。

五、常见误区与复盘

• 误区一：把 LVGL 的“样式状态”直接等同于 Qt 的 QSS 伪状态。LVGL 的样式可以叠加多层并精确控制优先级，QSS 的层叠规则更接近 CSS，且对自定义控件支持有限。
• 误区二：认为 Qt 不需要“主循环心跳”。Qt 的 QEventLoop 确实自动驱动，但如果你在 Qt 中嵌入 LVGL 或做跨线程 UI 更新，仍然要理解事件循环的阻塞与唤醒机制。
• 误区三：忽略渲染差异导致性能问题。LVGL 的脏矩形策略在低端 MCU 上非常高效，Qt 的 backing store 和 Scene Graph 更适合桌面/移动 GPU，迁移时不能照搬“局部刷新”的优化思路。
• 误区四：动画和定时器混用。LVGL 中动画和定时器是两套独立机制，Qt 中 QPropertyAnimation 内部也依赖定时器驱动，理解这一点才能正确设置帧率和插值曲线。

六、核心概念对照清单

把这七个概念串起来看，LVGL 的界面开发本质是“对象树 + 状态样式 + 事件回调 + 定时驱动 + 局部刷新”的闭环。Qt 虽然提供了更丰富的抽象和更自动化的运行时，但底层仍然遵循“对象生命周期、绘制请求、事件分发、动画驱动”的相似逻辑。理解这条链路，后续做 API 映射和架构迁移时，才能判断哪些能直接对应、哪些必须重写。