采用三状态原子机控制缓冲区切换、posix_memalign对齐内存预映射、write()+fdatasync()分离策略、writev()批量提交及专用限流flush线程，实现高吞吐低延迟日志写入。
一、采用三状态原子机控制缓冲区切换
仅用 std::atomic
1、声明状态变量：std::atomic
2、业务线程追加日志前，执行 while (state_.load() != READY_TO_WRITE) { std::this_thread::yield(); } 防止写入非就绪状态。
3、当检测到当前 buffer 剩余空间不足容纳下一条完整 log_entry 时，调用 compare_exchange_weak 尝试将 state_ 从 READY_TO_WRITE 更新为 SWITCHING。
4、若更新成功，则原子交换 front_buffer 与 back_buffer 指针，并立即将 state_ 置为 READY_TO_FLUSH；若失败，则 fallback 到 thread_local char[4096] 临时缓存，避免自旋耗尽 CPU。
5、刷盘线程消费完 READY_TO_FLUSH 状态的 buffer 后，调用 compare_exchange_strong 将 state_ 从 READY_TO_FLUSH 置为 READY_TO_WRITE，完成复用闭环。
二、使用 posix_memalign 分配对齐内存并预映射物理页
未对齐内存或首次访问触发缺页异常会导致 write() 延迟不可控，尤其在大 buffer 场景下可能引入毫秒级抖动。posix_memalign(4096, size) 确保地址按页对齐，配合 mlock() 锁定物理页可彻底消除 page fault，保障 memcpy 和 write() 的确定性延迟。
1、分配双缓冲区内存：char* buf_a; posix_memalign(&buf_a, 4096, 65536); 同样方式分配 buf_b，大小统一为 64KB（适配 SSD 高频小日志场景）。
2、分配成功后立即调用 mlock(buf_a, 65536) 锁住物理内存页；若权限不足则退而使用 memset(buf_a, 0, 65536) 主动触发首次映射。
3、禁止使用 new char[65536]、std::vector
4、write() 调用时传入的 buf 指针必须是 posix_memalign 返回的原始地址，不得偏移；否则内核校验失败返回 -EINVAL。
5、刷盘线程完成 write() 后，立即调用 posix_fadvise(fd_, 0, 65536, POSIX_FADV_DONTNEED) 提示内核释放对应 page cache，降低内存压力。
三、禁用 O_SYNC/O_DSYNC 并采用 write() + fdatasync() 分离策略
O_SYNC 和 O_DSYNC 会使每次 write() 强制等待磁盘确认，彻底废除双缓冲意义，将后台 flush 线程变为串行瓶颈。正确做法是仅在 buffer 满、空闲超 1 秒或显式 flush() 请求时调用 fdatasync()，兼顾持久性与吞吐量。
1、打开日志文件时使用标志：O_WRONLY | O_CREAT | O_APPEND | O_CLOEXEC；绝对禁用 O_SYNC 和 O_DSYNC。
2、flush 线程循环中，先调用 write(fd_, buf, used_len) 将整块 buffer 写入内核 page cache。
3、write() 成功返回后，检查该 buffer 是否已满或距上次写入已超 1000ms；满足任一条件则调用 fdatasync(fd_)。
4、fdatasync() 仅刷新数据页，不刷元数据，比 fsync() 延迟更低，且能保证崩溃后日志不丢。
5、绝不使用 fwrite() 或 std::ofstream —— 它们自带 libc 缓冲区，日志可能卡在用户态缓冲中，进程崩溃即丢失。
四、使用 writev() 批量提交与二进制结构体布局
频繁小 write() 会显著抬高系统调用开销，而字符串拼接格式化消耗大量 CPU。writev() 可合并多个日志项一次性提交，struct log_entry 采用紧凑二进制布局（如 uint64_t ts; uint8_t level; uint16_t len; char data[]），跳过解析与拼接，直写内存。
1、定义日志结构体：struct LogEntry { uint64_t timestamp; uint8_t level; uint16_t msg_len; char msg[]; };
2、格式化阶段将时间戳、等级、长度、消息内容依次 memcpy 到 buffer 中，严格按结构体字段对齐，避免跨字段截断。
3、当 buffer 中累积多条 LogEntry 且总长度 ≥ 4096 字节时，构造 iovec 数组，每个 iov_base 指向一条 LogEntry 起始地址，iov_len 为其 sizeof(LogEntry) + msg_len。
4、调用 writev(fd_, iov, iovcnt) 一次性提交，减少系统调用次数。
5、每条 LogEntry 的 msg_len 必须是实际有效字节数，禁止包含末尾 '\0' 或额外填充，防止读取越界或解析错误。
五、使用专用 flush 线程 + 限流防积压机制
后台 flush 线程若处理不过来，待刷 buffer 积压将引发 OOM 或丢日志。必须限制最大积压数量，并提供降级路径。专用线程避免上下文切换抖动，也便于 strace -e write 直接观测落盘行为。
1、声明 std::queue<:unique_ptr>> pending_buffers_; 配合 std::mutex 和 std::condition_variable 控制出入队。
2、业务线程在成功交换出满 buffer 后，将其 move 进 pending_buffers_；若队列 size() ≥ 2，则丢弃该 buffer 或降级为 fprintf(stderr, ...) 输出。
3、flush 线程主循环为 while (running_) { auto buf = pop_from_queue(); if (buf) { write(fd_, buf.get(), used_len); fdatasync(fd_); } else { std::this_thread::sleep_for(1ms); } }。
4、析构 logger 对象前，置 running_ = false 并 notify_one()；flush 线程在每次循环末尾检查 running_ 标志，避免永久挂起。
5、pending_buffers_ 出队后立即 std::move 到局部 unique_ptr，确保即使 write() 中途抛异常，buffer 内存也能自动释放。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
