必须用std::atomic控制切换，因普通变量切换非原子，会导致读写线程看到中间状态，引发日志丢失、乱序或崩溃；正确做法是用std::atomic配合compare_exchange_weak实现无锁、不可分割的状态翻转。
双缓冲区为什么必须用 std::atomic 控制切换
不加原子操作的缓冲区切换在多线程下必然出错——写线程可能刚把指针设为 buffer_a，读线程就看到一半切换状态，导致日志丢、乱序或崩溃。核心是：切换动作本身必须不可分割。
常见错误是用普通 bool 或 int 标记当前活跃缓冲区，比如：
bool use_buffer_a = true;
// 写线程中：
if (use_buffer_a) {
write_to(buffer_a);
} else {
write_to(buffer_b);
}
// 读线程中：
if (use_buffer_a) {
flush(buffer_a);
use_buffer_a = false; // 非原子赋值！
} else {
flush(buffer_b);
use_buffer_a = true;
}
正确做法是用 std::atomic<bool></bool> 或更推荐的 std::atomic<int></int>（0/1）控制索引，并配合 compare_exchange_weak 做无锁切换：
-
std::atomic<int> current_buffer{0}</int>表示当前写入缓冲区索引 - 写线程调用
current_buffer.load(std::memory_order_acquire)读取 - 读线程用
current_buffer.exchange(1 - old, std::memory_order_acq_rel)原子翻转 - 避免用
++或!直接操作原子变量，它们不保证读-改-写原子性
日志写入线程为何不能直接 fwrite 到磁盘文件
裸调 fwrite 在高并发下会成为瓶颈：每次调用都触发系统调用、内核锁、页缓存竞争，吞吐上不去，延迟抖动大。真正要的是批量落盘 + 减少 syscall 次数。
实操建议：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 写线程只负责把完整日志行追加到当前缓冲区（
std::vector<char></char>或预分配char*），不做任何 IO - 落盘线程用
writev或单次write把整个缓冲区内容刷出，而不是逐行fwrite - 打开文件时务必加
O_APPEND | O_WRONLY | O_CREAT，并禁用 stdio 缓冲：setvbuf(file, nullptr, _IONBF, 0) - 若需严格顺序，落盘线程应等前一个缓冲区
write返回成功后再切换，不能仅靠原子变量翻转就认为已落盘
std::thread 启动写线程后忘记 join 或 detach 的后果
主线程退出时，未 join 或 detach 的 std::thread 对象析构会直接调用 std::terminate，进程静默崩溃——这是 C++ 日志系统最常被忽略的致命坑。
尤其在日志类析构阶段，容易误以为“我已停止写入，线程自然结束”，但实际线程还在跑：
- 写线程循环中必须检查退出标志（如
std::atomic<bool> stop_requested</bool>），不能靠全局变量或静态 flag - 析构函数里先置
stop_requested = true，再cv.notify_all()唤醒等待中的线程 - 然后必须
thread_.join()；若用detach，等于放弃控制权，后续无法保证日志是否写完 - 推荐用 RAII 封装：构造时启动线程，析构时自动
join，避免手动管理遗漏
缓冲区大小设成 4KB 还是 64KB？影响远不止内存占用
缓冲区太小（如 4KB）会导致频繁切换和落盘，CPU 花在原子操作和上下文切换上的开销占比升高；太大（如 1MB）则增加日志延迟，且一次 write 可能被内核拆成多次，反而降低效率。
实测经验（Linux x86_64，SSD）：
- 64KB 是较优平衡点：接近页大小的整数倍，减少内核内存拷贝次数
- 若日志行普遍短于 256 字节，可设为 128KB，提升单次 write 吞吐
- 缓冲区必须按页对齐（
aligned_alloc(4096, size)），否则write可能失败或降级为 memcpy - 不要用
std::string存缓冲区——小字符串优化（SSO）导致内存布局不可控，换用std::vector<char></char>或裸指针 +malloc
双缓冲的本质不是省内存，而是解耦写入与落盘节奏。真正难的是让切换足够快、落盘足够稳、析构足够安全——这三处任一出问题，日志就不可信。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
