一文掌握 LVGL 9 的源码目录结构

LVGL (Light and Versatile Graphics Library) 是一款广泛应用于嵌入式 GUI 的轻量级开源图形库。从 v9 起，LVGL 在架构上进一步模块化，目录结构也更加清晰、易于维护。本文将对 LVGL 9 源码目录进行逐一讲解，帮助你快速理解每个文件夹的作用与使用场景。

🧭 顶层目录概览

解压 LVGL 源码后，你将看到如下目录结构：

lvgl/
├── demos/
├── docs/
├── env_support/
├── examples/
├── scripts/
├── src/
└── tests/

下面我们对每个目录进行详细解析：

📁 1. src/ — LVGL 的核心源码（🔥重点）

说明：这是 LVGL 的核心目录，包含所有控件、绘图系统、事件系统等源码。开发者在移植、调用或定制控件时，主要面对的就是这个目录。

典型子目录包括：

src/
├── core/        // 核心对象系统（对象创建、布局、事件派发等）
├── display/     // 显示驱动接口及屏幕刷新管理
├── draw/        // 绘图引擎（支持 CPU/GPU 加速）
├── font/        // 字体管理与解析
├── hal/         // 硬件抽象层（驱动适配接口）
├── misc/        // 工具模块（颜色转换、内存管理等）
├── themes/      // 主题与样式系统
└── widgets/     // 各种 UI 控件（按钮、滑块、标签等）

开发建议：

使用 LVGL 时大部分 API 都来自此目录，因此这是你学习和使用的核心。

📁 2. examples/ — API 示例

说明：包含模块化的功能示例，覆盖几乎所有控件与功能，官方文档中的 Demo 示例就是基于此生成的。

• 示例网址：https://docs.lvgl.io/9.1/examples.html

结构示例：

examples/
├── widgets/        // 控件类示例，如按钮、列表等
├── layouts/        // 布局示例，如 flex/grid 等
├── styles/         // 样式设置示例
├── event/          // 事件绑定和响应示例
└── others/

📁 3. demos/ — 综合演示项目

说明：这里是官方提供的“完整应用演示”，适合观察组件组合和多页应用如何构建。

• 可在线体验：https://lvgl.io/demos

📁 4. docs/ — 文档源文件

说明：包含 LVGL 官方文档的 Markdown 源文件，但我们通常不直接阅读，而是访问官方文档站点：

• 官方文档：https://docs.lvgl.io/9.1/

📁 5. env_support/ — 平台/环境适配支持

说明：用于对接不同的操作系统或平台，如 RT-Thread、Zephyr、裸机环境等。

使用场景：当你在移植 LVGL 到某个平台时，可以参考这里的结构编写驱动接口。

📁 6. scripts/ — 辅助脚本

说明：包含一些自动化脚本，如字体转换、代码检查、打包脚本等。

常见用途：

• 字体转码工具
• 调试辅助脚本

注意：开发者在正常使用 LVGL 时基本不会用到。

📁 7. tests/ — 自动化测试代码

说明：这是用于 LVGL 框架自身的 CI 测试逻辑。对于嵌入式开发者来说，一般不需要关心。

✅ 总结建议

📌 开发者建议

• 入门推荐：从 examples/ 入手，快速学习 API 用法；
• 进阶阅读：深入 src/ 理解 LVGL 控件、布局、事件机制；
• 平台移植：参考 env_support/ 完善你自己的驱动接口；
• UI 调试：运行 demos/，对比实现方式与效果。