环形缓冲区用于日志系统的核心目标是不丢关键数据、不拖慢主线程、不卡死系统；其设计强调指针控制、边界防护与覆盖策略，缓冲区大小须为2的幂以启用位运算优化，推荐计数器法判空满，并支持快照式导出。
环形缓冲区用于日志系统，核心目标不是“存得更多”，而是“不丢关键数据、不拖慢主线程、不卡死系统”。它特别适合突发写入（如崩溃前密集打点）、低功耗设备（如传感器节点）或资源受限环境（如裸机mcu）。关键不在结构多复杂，而在怎么用对指针、怎么控边界、怎么防覆盖。
缓冲区大小必须是2的幂次方
这不是可选项，是性能前提。Linux内核kfifo、STM32 HAL库的ring buffer实现都强制要求size = 1024 / 2048 / 4096等。原因很直接：模运算（index % size）会被编译器优化为位与（index & (size - 1)），速度提升5–10倍。若你用size=1000，不仅失去该优化，还可能因取模开销在中断上下文中引发延迟抖动。
建议做法：
- 按日志峰值速率预估：比如每秒最多写入2KB日志，保留2秒缓冲 → 至少4KB，选4096字节
- 嵌入式场景优先用512或1024字节，避免占用过多SRAM
- 不要动态计算size——初始化时就定死，运行期不改
区分“空”和“满”的三种可靠方式
只靠read_idx == write_idx无法同时判断空与满。教科书常用“牺牲一个单元”法，但实际工程中更推荐以下组合：
-
计数器法（推荐）：维护
valid_len变量，每次写入后valid_len++，读取后valid_len--。判断空：valid_len == 0；满：valid_len == size。线程安全需配合原子操作或锁 -
标志位法（裸机友好）：加一个
is_full布尔字段。写入前检查是否满；写入后若write_idx追上read_idx则置true；读取后若valid_len降为0则清false - 避免“单指针比较法”：即仅靠
read_idx == write_idx——它在中断+主循环共用同一缓冲区时极易误判，尤其在ARM Cortex-M系列弱内存序平台上
日志写入必须非阻塞且带覆盖策略
日志不是文件IO，不能等。一旦缓冲区满，应立即覆盖最旧日志（FIFO语义），而不是返回错误或挂起。否则业务线程可能被卡住，错过后续更关键的事件。
典型写入逻辑（C伪代码）：
- 计算待写长度
len，检查valid_len + len > size - 若超限，先移动
read_idx跳过最老(valid_len + len - size)字节，并更新valid_len - 执行分段拷贝：若
write_idx + len > size，先拷贝到末尾，再从头继续 - 最后更新
write_idx和valid_len，注意顺序：先更新数据，再更新索引
读取端要支持“快照式”导出
日志读取常发生在调试、dump或上传场景，此时需要一次性获取当前全部有效内容，且不能影响写入。正确做法不是边读边删，而是：
- 用
read_idx和valid_len算出逻辑起始位置和总长度 - 调用
memcpy做一次完整复制（目标可为临时栈缓冲或DMA内存） - 导出完成后，再统一调用
clear()或consume_all()重置read_idx和valid_len - 避免在读取过程中修改
read_idx——否则写入线程可能看到中间态，导致数据错乱
日志环形缓冲区不是越“大”越好，而是越“稳”越好。重点从来不在吞吐数字，而在崩溃时能否捞出最后一行trace，在中断里能否不丢一个字节，在低功耗唤醒瞬间能否立刻记下传感器异常值。
