1. LVGL调试入门：调试的重要性、常见工具概览、准备工作
说实话，我刚接触LVGL那会儿，也踩过不少坑。
屏幕不显示、触摸没反应、内存爆了、界面卡死……这些问题几乎每个嵌入式开发者都会遇到。我个人的经验是：调试能力，决定了你开发效率的上限。代码写得再快，不会调试，一样寸步难行。
为什么调试这么重要？
LVGL是一个图形框架，它运行在资源受限的嵌入式设备上。你想想看，MCU的RAM可能只有几十KB，Flash也就几百KB。在这种环境下，一个指针越界、一次内存泄漏、一个配置错误，都可能让整个系统崩溃。
我在项目中遇到过最典型的情况：
- 界面显示花屏，排查了两天，最后发现是
lv_disp_drv的buffer指针没对齐 - 触摸点击没反应，折腾半天，结果是
lv_indev_drv的read_cb回调里忘了调用lv_indev_feedback - 程序跑着跑着就HardFault，查到最后是
lv_obj_create之后没有判空
这些坑，如果你不会调试，可能花几天都找不到原因。但如果你掌握了调试方法，几分钟就能定位问题。
核心观点：调试不是“出了问题才做的事”，而是开发过程中必须贯穿始终的习惯。
常见调试工具概览
LVGL的调试工具，我按使用频率排个序：
| 工具/方法 | 用途 | 推荐指数 |
|---|---|---|
lv_log 日志系统 |
打印调试信息、错误、警告 | ⭐⭐⭐⭐⭐ |
| 串口打印 + 串口助手 | 查看运行时状态、变量值 | ⭐⭐⭐⭐⭐ |
| 断点调试（IDE/JLink） | 单步执行、查看内存、寄存器 | ⭐⭐⭐⭐ |
LVGL内置的lv_mem_monitor |
监控内存使用情况 | ⭐⭐⭐⭐ |
LVGL的lv_theme调试主题 |
可视化查看控件边界、对齐 | ⭐⭐⭐ |
| 逻辑分析仪/示波器 | 排查SPI/I2C通信、帧同步信号 | ⭐⭐⭐ |
我个人最常用的组合是：lv_log + 串口打印 + 断点调试。这三个基本能覆盖90%的问题。
小技巧：我习惯在项目初期就把LV_USE_LOG宏打开，设置日志等级为LV_LOG_LEVEL_WARN。这样既能过滤掉大量无关信息，又能在出现异常时第一时间看到警告。
调试前的准备工作
嗯，这里要注意。很多人一上来就写代码，出了问题才想起来调试。其实调试的准备工作，应该在写代码之前就做好。
1. 确认硬件基础
- 屏幕驱动正常吗？ 先跑一个纯色填充测试，确认像素能正常显示
- 触摸/按键能响应吗？ 用裸机程序测试一下输入设备的中断和读取
- 串口能打印吗？ 波特率、引脚、中断优先级，这些先调通
我曾经有一次，花了一整天调试LVGL的显示问题，最后发现是屏幕的复位引脚没拉高……从那以后，我每次都会先跑一个“点亮屏幕”的裸机程序，确认硬件没问题再上LVGL。
2. 配置LVGL的调试宏
在lv_conf.h中，有几个宏必须打开：
/* 打开日志系统 */
#define LV_USE_LOG 1
#define LV_LOG_LEVEL LV_LOG_LEVEL_WARN /* 或 LV_LOG_LEVEL_INFO */
/* 打开内存监控 */
#define LV_USE_MEM_MONITOR 1
/* 打开断言检查 */
#define LV_USE_ASSERT_NULL 1
#define LV_USE_ASSERT_MEM 1
#define LV_USE_ASSERT_OBJ 1
/* 打开性能分析（可选） */
#define LV_USE_PERF_MONITOR 1警告：这些宏在发布版本中建议关闭，因为它们会占用额外的RAM和CPU资源。但在开发阶段，一定要打开。我见过太多人为了省那几KB内存，把调试宏全关了，结果出了问题两眼一抹黑。
3. 准备一个“最小可运行”的工程
说白了，就是先让LVGL跑起来，哪怕只显示一个按钮。这样后续的调试才有基础。
我建议的步骤：
- 初始化LVGL核心：
lv_init() - 注册显示驱动：
lv_disp_drv_register() - 注册输入设备驱动：
lv_indev_drv_register() - 创建一个简单的界面：比如一个标签显示"Hello LVGL"
- 在主循环中调用
lv_timer_handler()
如果这一步能跑通，恭喜你，调试环境已经搭好了。如果跑不通，那就从硬件开始排查——别急着写复杂界面。
4. 准备好调试工具链
- 串口助手：推荐用SSCOM或Putty，支持颜色显示更好
- IDE调试器：Keil、IAR、VS Code + Cortex-Debug，至少熟悉一种
- 逻辑分析仪：便宜的24MHz采样率就够用，主要看SPI时序
我的习惯：在工程里预留一个debug_printf()函数，专门用来打印调试信息。这样即使后期关闭了LVGL的日志，我仍然可以自己控制打印内容。
小结
调试不是事后补救，而是开发流程的一部分。准备工作做得好，后面能省下大把时间。
下一章，我会详细讲LVGL的日志系统——怎么配置、怎么用、怎么看日志定位问题。到时候我会分享一个我实际项目中用日志排查内存泄漏的案例，挺有意思的。
公众号:蓝海资料掘金营，微信deep3321