简单理解：单个环形缓冲区 vs 双缓冲区对比表-平芜编程栈

对比项	单个大环形缓冲区	双缓冲区（双缓冲）
解决的核心问题	数据不会溢出、不会满	保证读到完整一整包、不被打断
读写方式	一边写、一边读，同时进行	写 A 时读 B，写 B 时读 A，互不干扰
数据完整性	可能读到一半旧一半新（脏数据）	永远是完整一包，安全干净
会不会满	缓冲区够大就不会满	也不会满，但重点不是防满
实现难度	简单，小白首选	稍复杂，用于特定场景
典型用途	串口收发、按键、小数据、调试	网络帧、音频、屏幕显示、DMA 整包处理
是否需要切换	不用切换，一个到底	需要来回切换 A/B
你现在是否需要	✅非常需要，必须掌握	❌ 暂时不用，进阶才学

一句话背下来

单个大环 = 防满、简单、通用
双缓冲 = 保整包、不被打扰、专用

【方案 1】单个大环形缓冲区（不会满、通用、最简单）

👉 适用：串口、不断收发、一边写一边读、不会丢数据

// 包含固定类型支持，比如 uint8_t = 1个字节 #include <stdint.h> // 包含 true / false #include <stdbool.h> //============================= // 缓冲区大小 // 设大一点 = 永远不会满！ //============================= #define RING_BUFFER_SIZE 256 //============================= // 环形缓冲区结构体 // 一个结构体 = 一个完整缓冲区 //============================= typedef struct { // 真正用来存数据的数组 uint8_t buffer[RING_BUFFER_SIZE]; // 写指针：下一个数据要写到哪里 volatile uint16_t head; // 读指针：下一个数据从哪里读 volatile uint16_t tail; } RingBuffer; //============================= // 初始化缓冲区 // 作用：清空数据，指针归零 //============================= void RingBuffer_Init(RingBuffer *rb) { // 写指针回到 0 rb->head = 0; // 读指针回到 0 rb->tail = 0; } //============================= // 写入 1 个字节 // 返回：true=成功，false=满 //============================= bool RingBuffer_Put(RingBuffer *rb, uint8_t data) { // 计算下一个写位置 uint16_t next_head = (rb->head + 1) % RING_BUFFER_SIZE; // 如果下一个写位置 == 读位置 → 满了 if (next_head == rb->tail) { return false; } // 把数据写入当前 head 位置 rb->buffer[rb->head] = data; // 写指针向后移动 rb->head = next_head; return true; } //============================= // 读取 1 个字节 // 返回：true=成功，false=空 //============================= bool RingBuffer_Get(RingBuffer *rb, uint8_t *out_data) { // 如果 head == tail → 没有数据 if (rb->head == rb->tail) { return false; } // 从 tail 位置读出数据 *out_data = rb->buffer[rb->tail]; // 读指针向后移动 rb->tail = (rb->tail + 1) % RING_BUFFER_SIZE; return true; } //============================= // 判断是否为空 //============================= bool RingBuffer_IsEmpty(RingBuffer *rb) { return (rb->head == rb->tail); } //============================= // 判断是否已满 //============================= bool RingBuffer_IsFull(RingBuffer *rb) { uint16_t next_head = (rb->head + 1) % RING_BUFFER_SIZE; return (next_head == rb->tail); }

【方案 2】双缓冲区（保证数据完整、不被打扰）

👉 适用：整包数据、网络、音频、DMA、不能边读边改

// 固定头文件 #include <stdint.h> #include <stdbool.h> //============================= // 每个缓冲区大小 //============================= #define DOUBLE_BUF_SIZE 128 //============================= // 双缓冲区结构体 //============================= typedef struct { // 两个独立缓冲区 A 和 B uint8_t bufA[DOUBLE_BUF_SIZE]; uint8_t bufB[DOUBLE_BUF_SIZE]; // 当前正在写入的缓冲区（指向 A 或 B） uint8_t *write_buf; // 当前写了多少字节 uint16_t write_pos; // 是否有一整块数据准备好了可以读 bool data_ready; } DoubleBuffer; //============================= // 初始化双缓冲区 //============================= void DoubleBuffer_Init(DoubleBuffer *db) { // 一开始用 A 来写 db->write_buf = db->bufA; // 写位置从0开始 db->write_pos = 0; // 一开始没有数据可读 db->data_ready = false; } //============================= // 写入 1 字节 //============================= bool DoubleBuffer_Write(DoubleBuffer *db, uint8_t data) { // 如果有数据还没读，不能写（防止覆盖） if (db->data_ready) { return false; } // 把数据写入当前写缓冲区 db->write_buf[db->write_pos] = data; // 位置往后移 db->write_pos++; // 如果写满了 if (db->write_pos >= DOUBLE_BUF_SIZE) { // 切换缓冲区 if (db->write_buf == db->bufA) { db->write_buf = db->bufB; } else { db->write_buf = db->bufA; } // 重置写位置 db->write_pos = 0; // 标记：有一整块数据可以读 db->data_ready = true; } return true; } //============================= // 读取一整块数据 //============================= bool DoubleBuffer_Read(DoubleBuffer *db, uint8_t **out_buf, uint16_t *out_len) { // 没有准备好的数据 if (!db->data_ready) { return false; } // 找到上一个写满的缓冲区 if (db->write_buf == db->bufA) { *out_buf = db->bufB; } else { *out_buf = db->bufA; } // 长度是满包长度 *out_len = DOUBLE_BUF_SIZE; // 清除标志 db->data_ready = false; return true; } //============================= // 是否有完整数据可以读 //============================= bool DoubleBuffer_IsReady(DoubleBuffer *db) { return db->data_ready; }