第2章 LVGL内存监控：从黑盒到白盒

做嵌入式图形开发，最怕什么？我最怕的是设备跑着跑着突然卡死，或者界面莫名其妙花屏。排查到最后，十有八九是内存出了问题。LVGL作为一个资源敏感的GUI框架，内存管理直接决定了系统的稳定性。这一章，我们就来聊聊怎么把LVGL的内存状态看清楚。

2.1 为什么需要内存监控？

先讲个我自己的经历。几年前做一款智能家居面板，界面已经开发完了，测试也通过了。结果量产前做老化测试，第三天屏幕就花了。查了两天，发现是内存泄漏——某个页面切换时创建了图片缓存，但退出时没释放。如果当时有内存监控，这个问题半小时就能定位。

LVGL的内存管理其实挺透明的。它提供了完整的监控接口，关键是你得会用。说白了，内存监控能帮你做三件事：

• 实时查看内存使用量——当前用了多少、还剩多少
• 分析内存碎片化程度——为什么明明有空闲内存，却分配失败
• 检测内存泄漏——谁申请了内存不还

这三件事，对应着三个核心工具：lv_mem_monitor()、碎片化分析、泄漏检测。我们一个一个来。

2.2 lv_mem_monitor()：内存的体检报告

lv_mem_monitor()是LVGL提供的内存状态快照函数。调用它，你能拿到当前内存池的完整信息。我个人习惯在调试阶段，每隔几秒调用一次，观察内存变化趋势。

2.2.1 函数原型与数据结构

typedef struct {
    uint32_t total_size;   // 内存池总大小（字节）
    uint32_t free_cnt;     // 空闲内存块数量
    uint32_t free_size;    // 空闲内存总大小（字节）
    uint32_t free_biggest_size; // 最大连续空闲块大小
    uint32_t used_cnt;     // 已使用内存块数量
    uint32_t used_size;    // 已使用内存总大小（字节）
    lv_mem_monitor_t;
};

void lv_mem_monitor(lv_mem_monitor_t * mon_p);

这个结构体里，我最关注两个字段：free_biggest_size和used_cnt。为什么？往下看。

2.2.2 实战：写一个内存监控任务

在实际项目中，我通常会创建一个低优先级任务，每隔5秒打印一次内存状态。代码长这样：

static void memory_monitor_task(lv_task_t * task) {
    lv_mem_monitor_t mon;
    lv_mem_monitor(&mon);

    LV_LOG_INFO("=== LVGL Memory Status ===");
    LV_LOG_INFO("Total: %d bytes", mon.total_size);
    LV_LOG_INFO("Used: %d bytes (%d%%)", mon.used_size,
                mon.used_size * 100 / mon.total_size);
    LV_LOG_INFO("Free: %d bytes", mon.free_size);
    LV_LOG_INFO("Fragmentation: %d%%",
                (mon.free_size - mon.free_biggest_size) * 100 / mon.free_size);
    LV_LOG_INFO("Free blocks: %d, Used blocks: %d",
                mon.free_cnt, mon.used_cnt);
}

// 在初始化时创建
lv_task_create(memory_monitor_task, 5000, LV_TASK_PRIO_LOW, NULL);

2.3 内存碎片化分析：看不见的杀手

碎片化是个很隐蔽的问题。你明明看到free_size还有好几KB，但分配一个几百字节的buffer却失败了。为什么会这样？因为空闲内存被切成了很多小块，没有一块足够大。

我遇到过最夸张的一次，free_size显示还有12KB，但free_biggest_size只有256字节。整个内存池碎成了几十个小碎片，连一个图标都加载不了。

2.3.1 碎片化的成因

碎片化主要来自两个操作：

• 频繁分配和释放不同大小的内存块——比如创建控件、加载图片、分配临时buffer
• 长时间运行不重启——碎片会随着时间累积

你想想看，内存池就像一块空地。你在这里盖个房子（分配），那里拆个棚子（释放），时间长了，空地就变成了一堆小地块，盖不了大房子。

2.3.2 如何量化碎片化程度

除了前面提到的碎片化率，还有一个指标叫内存利用率：

指标	计算公式	健康范围	说明
碎片化率	(free_size - free_biggest_size) / free_size	< 20%	越低越好
内存利用率	used_size / total_size	40% - 70%	太高容易碎片，太低浪费
块数比	free_cnt / used_cnt	< 0.5	空闲块太多说明碎片严重

2.4 内存泄漏检测：谁偷了我的内存？

内存泄漏比碎片化更致命。碎片化至少内存还在，泄漏是内存真的丢了。LVGL 8.x之后提供了内置的泄漏检测机制，但需要你主动开启。

2.4.1 开启泄漏检测

在lv_conf.h中设置：

/* 开启内存调试 */
#define LV_MEM_CUSTOM      0
#define LV_MEM_BUF_MAX_NUM 16

/* 开启泄漏检测（调试阶段用） */
#define LV_USE_DEBUG        1
#define LV_USE_PERF_MONITOR 1

开启后，LVGL会在每次分配和释放时记录调用栈。如果某个内存块被分配后没有被释放，它会在日志中打印出来。

2.4.2 手动泄漏检测方法

如果不想依赖内置工具，也可以自己写一个简单的泄漏检测器。原理很简单：记录每次分配的内存地址，在释放时移除，最后检查哪些地址没有被释放。

// 简易泄漏检测器
static lv_ll_t leak_tracker;

typedef struct {
    void * ptr;
    uint32_t size;
    const char * file;
    uint32_t line;
} leak_entry_t;

void leak_init(void) {
    lv_ll_init(&leak_tracker, sizeof(leak_entry_t));
}

void * leak_malloc(uint32_t size, const char * file, uint32_t line) {
    void * ptr = lv_mem_alloc(size);
    if(ptr) {
        leak_entry_t * entry = lv_ll_ins_head(&leak_tracker);
        entry->ptr = ptr;
        entry->size = size;
        entry->file = file;
        entry->line = line;
    }
    return ptr;
}

void leak_free(void * ptr) {
    lv_mem_free(ptr);
    // 从链表中移除对应条目
    lv_ll_t * node = lv_ll_get_head(&leak_tracker);
    while(node) {
        leak_entry_t * entry = (leak_entry_t *)node;
        if(entry->ptr == ptr) {
            lv_ll_remove(&leak_tracker, node);
            break;
        }
        node = lv_ll_get_next(&leak_tracker, node);
    }
}

void leak_report(void) {
    lv_ll_t * node = lv_ll_get_head(&leak_tracker);
    uint32_t total_leak = 0;
    while(node) {
        leak_entry_t * entry = (leak_entry_t *)node;
        LV_LOG_ERROR("LEAK: %p size=%d at %s:%d",
                     entry->ptr, entry->size,
                     entry->file, entry->line);
        total_leak += entry->size;
        node = lv_ll_get_next(&leak_tracker, node);
    }
    LV_LOG_ERROR("Total leaked: %d bytes", total_leak);
}

2.5 本章知识体系总览

下面这张图总结了内存监控的完整流程。你可以把它当作调试时的检查清单：

2.6 实战建议：建立你的监控习惯

说了这么多，最后给几条实操建议：

1. 开发阶段就开启监控——不要等到出问题了再查。我每个项目都会在初始化代码里加上内存监控任务，从第一天就开始看内存变化。
2. 记录基线数据——在功能稳定的版本里，记录正常状态下的内存使用量。这样新功能引入后，对比基线就能快速发现异常。
3. 压力测试不可少——反复切换页面、快速操作控件，观察内存是否持续增长。如果used_size只升不降，大概率有泄漏。
4. 碎片化率超过20%就要警惕——这时候可以考虑整理碎片，或者调整分配策略。具体怎么做，后面的章节会详细讲。