4. 环形缓冲区原理

环形缓冲区，说白了就是一个固定大小的内存块，用两个指针来管理读写位置。我刚开始接触嵌入式日志系统时，第一反应是用动态链表来存日志——结果在资源受限的MCU上跑得那叫一个惨。后来才明白，环形缓冲区才是嵌入式日志的基石。

4.1 环形缓冲区数据结构

环形缓冲区的核心数据结构其实很简单。我习惯这样定义：

typedef struct {
    uint8_t *buffer;    // 数据存储区
    uint32_t size;      // 缓冲区大小（必须是2的幂）
    uint32_t head;      // 写指针
    uint32_t tail;      // 读指针
    uint32_t count;     // 当前数据量（可选）
} ring_buffer_t;

这里有个小细节——size为什么建议是2的幂？因为可以用位运算代替取模，速度能快不少。我在一个每秒要处理上千条日志的项目里试过，性能差距很明显。

4.2 读写指针管理

读写指针的管理，是环形缓冲区最核心的逻辑。你想想看，两个指针在环上你追我赶，稍不留神就会出问题。

写操作流程

int ring_buffer_write(ring_buffer_t *rb, uint8_t data) {
    uint32_t next_head = (rb->head + 1) & (rb->size - 1);
    
    // 检查是否满
    if (next_head == rb->tail) {
        return -1;  // 缓冲区满
    }
    
    rb->buffer[rb->head] = data;
    rb->head = next_head;
    rb->count++;
    return 0;
}

读操作流程

int ring_buffer_read(ring_buffer_t *rb, uint8_t *data) {
    // 检查是否空
    if (rb->head == rb->tail) {
        return -1;  // 缓冲区空
    }
    
    *data = rb->buffer[rb->tail];
    rb->tail = (rb->tail + 1) & (rb->size - 1);
    rb->count--;
    return 0;
}

嗯，这里要注意一个陷阱：空和满的判断。当head == tail时，到底是空还是满？我见过不少新手在这里栽跟头。常用的做法是牺牲一个存储单元，让head永远追不上tail——也就是缓冲区最多存size - 1个元素。

4.3 溢出处理策略

缓冲区满了怎么办？这问题我在实际项目中遇到过好几次。不同的场景，策略完全不同。

策略一：丢弃新数据

最保守的做法。新数据来了，如果缓冲区满了就直接丢掉。适合那些「丢了就丢了，无所谓」的场景——比如一些调试日志。

// 实现就是上面写的，满了返回-1

策略二：覆盖旧数据

我更喜欢这种。日志系统嘛，最新的数据往往最有价值。旧数据被覆盖了也无所谓，反正我们关注的是最近发生了什么。

int ring_buffer_write_force(ring_buffer_t *rb, uint8_t data) {
    uint32_t next_head = (rb->head + 1) & (rb->size - 1);
    
    // 如果满了，移动tail腾出空间
    if (next_head == rb->tail) {
        rb->tail = (rb->tail + 1) & (rb->size - 1);
        rb->count--;
    }
    
    rb->buffer[rb->head] = data;
    rb->head = next_head;
    rb->count++;
    return 0;
}

策略三：动态扩展

这个我一般不建议。嵌入式系统内存本来就紧张，动态分配容易出问题。但有些场景确实需要——比如系统启动时日志量特别大，过后就平稳了。

4.4 环形缓冲区核心逻辑图

下面这张图展示了环形缓冲区的工作流程。我特意把读写指针的移动路径画出来了，你一看就明白。

4.5 实际应用中的考量

讲完了原理，说说实际中怎么用。我总结了几条经验：

• 中断安全：如果读写操作可能被中断打断，记得关中断或使用原子操作。我吃过这个亏——中断里写日志，主循环读日志，结果数据全乱了。
• 多生产者/消费者：多个任务同时写？加锁。但别用重量级的互斥锁，关中断或者用信号量就够了。
• 批量操作：一次读写一个字节效率太低。我习惯一次读写一块数据，配合DMA使用，性能能翻好几倍。

环形缓冲区这东西，看着简单，用好了真能解决大问题。我见过有人用环形缓冲区实现了毫秒级的日志记录，配合压缩算法，在只有64KB RAM的MCU上跑得稳稳的。嗯，下一节我们就聊聊怎么把日志压缩起来。

---

公众号:蓝海资料掘金营，微信deep3321