环形缓冲区必须用原子操作或锁保护，因仅靠head/tail索引无法避免多线程数据竞争；容量须为2的幂以用位运算替代模运算；push/pop需先检查可用空间再操作指针，确保零拷贝与内存安全。
环形缓冲区为什么必须用原子操作或锁来保护
多线程读写同一个 ring_buffer 时，仅靠 head 和 tail 两个索引无法保证一致性。比如生产者刚算出可写位置，被调度器切走，消费者此时读走数据并更新 tail，等生产者恢复执行就可能覆写未消费数据——这不是“偶尔出错”，而是必然发生的数据竞争。
单生产者单消费者（SPSC）场景下可用 std::atomic<int></int> 配合 memory_order_acquire/memory_order_release；多生产者或多消费者必须加锁，std::mutex 开销可控，别迷信“无锁一定更快”。
如何避免模运算成为性能瓶颈
用 % 计算环形索引在 x86 上实际会触发除法指令，比位运算慢一个数量级。唯一可靠解法是让缓冲区长度为 2 的幂（如 1024、4096），然后把所有索引计算改成 index & (capacity - 1)。
这意味着：
• 构造时必须校验 capacity 是 2 的幂，否则直接 assert(false) 或抛异常
• 不要试图在运行时动态调整容量——那会破坏位运算前提
• 如果业务要求非 2 的幂长度，老老实实用 %，别为了“理论优化”引入边界错误
push/pop 操作如何设计才能零拷贝且不越界
核心是区分“空间是否足够”和“数据是否已就位”。典型错误是先移动 tail 再拷贝数据，导致消费者看到未初始化内存。
正确流程：
• push() 先调用 available_write() 检查剩余空间，返回的是可安全写入的字节数
• 用 data() + write_offset 获取裸指针，由调用方完成 memcpy 或 placement new
• 最后原子更新 tail
• pop() 同理：先 available_read()，再取指针，最后更新 head
这样既支持任意类型（包括 non-trivial 类型需调用构造/析构），又避免内部做多余拷贝
std::array vs malloc 分配内存时的关键取舍
编译期确定长度用 std::array<t n></t> 最省事，但 N 必须是常量表达式；运行时决定长度只能用 new T[N] 或 std::unique_ptr<t></t>。
注意：
• std::vector<t></t> 不适合——它自带 size/capacity 管理，和环形逻辑冲突，且可能触发额外内存分配
• 手动 malloc + placement new 可控性最强，但得自己管对齐（尤其 T 有 SIMD 成员时）
• 如果用 std::unique_ptr<uint8_t></uint8_t>，记得按 alignof(T) 对齐分配，否则 reinterpret_cast<t>(ptr)</t> 是未定义行为
缓冲区长度必须是 2 的幂这点容易被忽略，调试时发现性能突然断崖下跌，八成是忘了检查 capacity 是否合规。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
