thread_local栈缓冲+writev多段提交必须值拷贝LogEntry，因其需确保iov_base指向结构体内嵌缓冲区且生命周期绑定；若用std::string_view或裸指针引用局部数组，队列消费时栈帧已销毁，导致野指针和性能归零。
零拷贝 Buffer 翻转不是把两块内存来回指一下就能跑起来——只要格式化结果在 writev() 返回前被复用、栈缓冲提前析构、或 iovec.iov_base 指向悬垂地址，就立刻退化为普通拷贝路径，性能归零。
thread_local 栈缓冲 + writev 多段提交为什么必须值拷贝 LogEntry
常见错误是让日志函数返回 std::string_view 或裸指针指向局部 std::array<char></char>，然后塞进队列。问题在于：std::string_view 不拥有数据，队列消费时原栈帧早已退出，iov_base 变成野指针。
- 正确做法：前端在
log()函数内完成全部格式化（如用fmt::format_to_n()写入thread_local std::array<char></char>），记录实际长度len，构造一个含iovec成员的LogEntry结构体，以值方式（queue.enqueue(entry)）拷贝进无锁队列 -
LogEntry必须是 POD 类型，不含虚函数、不含非 trivial 析构成员；字段如iovec msg;中的iov_base必须指向该结构体内嵌缓冲区（如char buf[4096]），而非外部栈地址 - 禁用任何隐式生命周期延长：不要对局部数组取
.data()后存std::string_view，也不要传std::span进队列
双缓冲翻转为何必须用三状态原子机而非布尔开关
只用 std::atomic<bool></bool> 切换两个缓冲区指针，会触发“半截日志”读错：生产者刚 memcpy 了前 20 字节，指针就被消费者交换走，消费者从头开始解析，得到乱序 log_entry 结构。
- 必须用
std::atomic<int></int>表达三态：0 = READY_TO_WRITE、1 = SWITCHING、2 = READY_TO_FLUSH - 生产者写入前检查状态是否为 0；若为 1，最多自旋 100 次（
std::this_thread::yield()），之后 fallback 到thread_local char[4096]临时缓冲 - 切换时顺序不可乱：先
compare_exchange_strong(state, 0, 1)，再原子交换缓冲区指针，最后state.store(2)；每步之间加std::atomic_thread_fence(std::memory_order_release) - 缓冲区本身必须是
alignas(8)对齐的struct，避免单次写入跨 cache line 导致字节撕裂
posix_memalign 分配缓冲区时容易忽略的对齐与释放规则
用 malloc() 或 new[] 分配缓冲区，即使大小是 4096 的倍数，地址也不保证页对齐——io_uring 注册或 splice() 转发时会直接失败（EINVAL）或静默降级为拷贝路径。
立即学习“C++免费学习笔记（深入）”；
- 必须用
posix_memalign(&buf, 4096, size)；Windows 下对应_aligned_malloc()，且释放时分别用free()和_aligned_free() - 分配后立即验证：
if (reinterpret_cast<uintptr_t>(buf) % 4096 != 0)</uintptr_t>，不满足则 abort 或重试 - 注册到
io_uring的缓冲区，长度也必须是 4096 整数倍；注册后禁止realloc、free或跨线程释放，否则下次提交可能触发 page fault - 别试图让
std::vector底层用对齐内存——重载全局operator new风险太高；应封装aligned_allocator并显式传入模板参数
writev 批量刷盘时文件打开标志和 fsync 时机怎么设才不废掉双缓冲
哪怕缓冲区翻转再无锁、writev() 再高效，只要文件用 O_SYNC 打开，每次调用都会等磁盘确认，双缓冲彻底失效，吞吐断崖下跌。
- 文件必须用
O_WRONLY | O_CREAT | O_APPEND打开；绝对禁用O_SYNC和O_DSYNC -
writev()调用频率决定吞吐：攒够 4–8KB 再刷，比单条日志write()减少 70%+ 系统调用次数 -
fsync()只在三种时机触发：缓冲区满、空闲超 1s、或用户显式调用flush()；绝不能放在每条日志末尾 - 刷盘线程中禁止任何字符串操作（如
std::to_string）、禁止堆分配、禁止系统调用以外的阻塞操作——否则业务线程 fallback 路径会被拖垮
最易被忽略的一点：所有格式化必须在入队前完成，且输出内存块的生命周期必须严格绑定到 LogEntry 值拷贝本身。一旦你让刷盘线程去调 fmt::format() 或拼接 std::string，零拷贝就已不复存在。
