乒乓buffer通过双缓冲交替读写实现无缝传输，核心在于并行操作、无缝切换和带宽倍增，避免单缓冲导致的丢帧或卡顿。
直接用 std::queue + std::mutex 做双缓冲翻转，吞吐量会掉 70% 以上——这不是配置问题，是锁竞争和伪共享的硬伤。必须用原子状态机控制缓冲区所有权，且写入与刷盘路径完全分离。
为什么 std::atomic 交换指针还不够安全
只交换缓冲区指针，不控制写入语义，会导致消费者读到半截日志。比如生产者刚 memcpy 了前 12 字节，指针就被切换，消费者从头开始 read，结果解析出错乱结构体。
- 必须配合内存屏障：
std::atomic_thread_fence(std::memory_order_release)在写入完成后、交换前插入，确保所有写操作对其他线程可见 - 缓冲区结构体（如
log_entry）必须自然对齐（alignas(8)），避免跨 cache line 写入引发字节撕裂 - 推荐用三状态原子整数：
std::atomic<int></int>表示READY_TO_WRITE/SWITCHING/READY_TO_FLUSH，而非布尔值——SWITCHING是关键中间态，漏掉就可能丢数据或死锁
环形缓冲区不能用 std::vector 或 std::deque
它们的 push_back() 可能触发 reallocate，破坏无锁前提；且动态扩容引入额外分支判断和堆分配，无法保证写入路径恒定时间。
- 必须预分配固定大小：例如
std::array<char></char>或char* buf = static_cast<char>(aligned_alloc(4096, size))</char> - 索引管理用
std::atomic<size_t></size_t>，读写位置各自独立，避免伪共享（把 reader_idx 和 writer_idx 放在不同 cache line） - 写入时先检查剩余空间：
if (writer_idx.load() + len > capacity) return false;，满则触发翻转，不阻塞、不重试
翻转时如何防止业务线程被卡住
消费者线程刷盘慢（比如磁盘卡顿），若生产者一直自旋等待 SWITCHING 结束，会拖垮整个服务。必须有 fallback 路径。
- 生产者发现状态为
SWITCHING时，最多自旋 100 次（std::this_thread::yield()），之后转入thread_local char[4096]临时缓冲 - 临时缓冲满或日志函数返回前，尝试再次提交到主缓冲区；失败则丢弃（需可配置告警）
- 绝不能让
log()调用进入系统调用（如write()）或 malloc，否则异步意义归零
writev() 批量落盘比单次 write() 快 3–5 倍
每次 write() 都要陷入内核、校验参数、查 fd 表——哪怕只写 32 字节。而 writev() 一次提交多个 iovec，系统调用开销摊薄。
- 刷盘线程收集当前缓冲区所有完整日志项，构造成
std::vector<iovec></iovec>，再一次性writev(fd, iov.data(), iov.size()) - 文件打开必须用
O_APPEND | O_WRONLY | O_CREAT，禁用O_SYNC和O_DSYNC——它们会让writev()等磁盘确认，废掉双缓冲 -
fsync()只在三种时机触发：缓冲区满、空闲超 1s、或显式调用flush()；绝不放在每条日志末尾
真正难的不是“怎么翻转”，而是翻转前后那一瞬间的内存可见性、结构体完整性、以及业务线程的零等待承诺——这三个点没压住，性能数字看着漂亮，线上一压就崩。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
