3. LVGL图片缓存机制：深入理解cache工作原理
图片缓存，说白了就是LVGL在内存里给你开的一个“小仓库”。每次解码完一张图片，它不会立刻扔掉，而是先存起来。下次再显示同一张图，直接从仓库拿，省得重新解码。
我刚开始用LVGL做项目时，没太在意这个缓存。结果呢？界面切换卡得不行，尤其是那些大尺寸的JPEG图片，每次切换都要等个几百毫秒。后来一查，原来是缓存没配好。嗯，这节课我们就把它彻底搞明白。
核心结论：LVGL的图片缓存默认是关闭的。你需要手动开启并配置大小。不配置，就等于每次显示图片都重新解码，性能自然上不去。
3.1 缓存到底存了什么？
LVGL的缓存，存的是解码后的像素数据。不是原始文件（比如PNG、JPEG的二进制流），而是已经解压成RGB565或ARGB8888格式的像素数组。
举个例子：一张100×100的RGB565图片，解码后占100×100×2 = 20KB。如果缓存里存了这张图，下次显示时直接把这20KB数据刷到显存就行，不需要再调用解码器。
| 缓存条目 | 存储内容 | 典型大小 |
|---|---|---|
| 原始文件 | PNG/JPEG/BMP二进制流 | 几KB~几百KB |
| 缓存数据 | 解码后的像素数组 | 宽×高×像素深度 |
我的经验：一张800×480的全屏RGB565图片，解码后大约占用800×480×2 ≈ 768KB。如果你的缓存总大小只有512KB，那这张图永远进不了缓存——每次都得重新解码。这就是卡顿的根源之一。
3.2 缓存策略：LRU淘汰机制
LVGL用的是LRU（Least Recently Used）淘汰策略。什么意思呢？就是缓存满了之后，优先淘汰那些“最久没被用过”的图片。
我个人觉得这个策略很合理。你想想看，用户界面上来回切换的通常就那么几张图，比如背景图、图标、按钮图片。那些只出现一次的启动画面，用完就再也不会显示了，淘汰掉正好。
LRU在LVGL里的实现大致是这样的：
- 每次显示图片时，LVGL先去缓存里找。
- 找到了，就把这张图移到“最近使用”的位置。
- 没找到，就解码并插入缓存。如果缓存满了，就把“最久未使用”的那张踢出去。
注意：LRU淘汰的是整个缓存条目，不是部分数据。一张大图可能顶掉好几张小图。我曾经遇到过一个问题：缓存里全是小图标，突然加载一张全屏背景图，结果所有图标都被踢出去了。切换回图标页面时，图标又要重新解码，反而更慢了。
3.3 如何配置缓存？
配置缓存其实就两个参数：缓存大小和缓存条目数量。在lv_conf.h里设置。
/* lv_conf.h */
/* 1. 开启图片缓存 */
#define LV_IMG_CACHE_DEF_SIZE 0 /* 默认是0，表示关闭缓存 */
/* 2. 设置缓存大小（单位：字节） */
#define LV_IMG_CACHE_DEF_SIZE 1024 * 1024 /* 1MB */
/* 3. 设置最大缓存条目数 */
#define LV_IMG_CACHE_DEF_ENTRIES 50 /* 最多缓存50张图片 */这里有几个关键点：
- LV_IMG_CACHE_DEF_SIZE：缓存总容量。建议设为系统空闲RAM的10%~20%。
- LV_IMG_CACHE_DEF_ENTRIES：最大条目数。不是越多越好，条目太多会导致LRU查找变慢。
配置建议：
- RAM充足（>512KB）：缓存设2MB，条目数100
- RAM中等（128KB~512KB）：缓存设512KB，条目数50
- RAM紧张（<128KB）：缓存设128KB，条目数20，或者干脆关闭缓存，手动管理
3.4 运行时动态控制缓存
除了编译时配置，你还可以在运行时动态操作缓存。我个人习惯在项目初始化时统一设置：
/* 运行时设置缓存大小 */
lv_img_cache_set_size(1024 * 1024); /* 设置1MB缓存 */
/* 手动清空缓存 */
lv_img_cache_invalidate_src(NULL); /* 清空所有缓存 */
/* 清空指定图片的缓存 */
lv_img_cache_invalidate_src("S:/images/bg.png");为什么要手动清空？我在项目中遇到过这种情况：用户切换主题时，所有图片资源都变了。如果不清空缓存，旧主题的图片还占着位置，新图片反而进不来。这时候调用一次lv_img_cache_invalidate_src(NULL)，干净利落。
3.5 缓存命中率：你该关注的核心指标
配置了缓存，怎么知道它有没有生效？看命中率。LVGL没有直接提供命中率统计接口，但你可以自己算：
/* 伪代码：统计缓存命中率 */
static uint32_t cache_hit = 0;
static uint32_t cache_miss = 0;
/* 在图片加载回调里统计 */
void my_img_load_cb(const char *src) {
if (lv_img_cache_is_cached(src)) {
cache_hit++;
} else {
cache_miss++;
}
}
/* 打印命中率 */
float hit_rate = (float)cache_hit / (cache_hit + cache_miss) * 100.0f;
LV_LOG_USER("Cache hit rate: %.1f%%", hit_rate);我一般要求项目里的缓存命中率在80%以上。低于这个值，说明缓存配置不合理，或者图片资源管理有问题。
避坑指南：我曾经在一个项目里发现命中率只有30%。排查了半天，原来是图片路径写得不一致。有时候用"S:/images/bg.png"，有时候用"S:/images/BG.png"。LVGL的缓存key是区分大小写的！统一路径格式后，命中率直接飙到95%。
3.6 缓存与内存碎片
这里要提一个容易被忽略的问题：内存碎片。LVGL的缓存是在堆上动态分配的。频繁地加载、淘汰图片，会导致内存碎片越来越多。
我建议的做法是：
- 尽量让缓存里的图片大小相近。比如图标统一用32×32，背景图统一用全屏尺寸。
- 避免频繁加载超大图片。如果必须用，考虑用
lv_img_decoder_open直接解码到指定内存区域，绕过缓存。 - 定期检查堆内存使用情况。LVGL提供了
lv_mem_monitor_t结构体，可以查看碎片率。
lv_mem_monitor_t mon;
lv_mem_monitor(&mon);
LV_LOG_USER("Used: %d, Free: %d, Frag: %d%%",
mon.used_size, mon.free_size, mon.frag_pct);碎片率超过30%就要警惕了。我一般会在碎片率超过20%时，主动调用一次lv_img_cache_invalidate_src(NULL)，然后重新加载当前界面的图片。虽然会有一瞬间的卡顿，但比系统崩溃强。
3.7 本章小结：一张图看懂缓存机制
下面这张SVG图，把LVGL图片缓存的完整流程画出来了。从图片加载请求开始，到缓存命中/未命中的处理，再到LRU淘汰，一目了然。
这张图把整个流程串起来了。你仔细看就会发现，缓存命中的路径非常短，只有两步：查找→更新LRU→显示。而缓存未命中的路径就长得多：解码→检查空间→可能淘汰→插入→显示。这就是为什么缓存命中率直接决定了图片加载的流畅度。