std::ofstream不能用于高性能异步写入，因其同步阻塞、无用户态分级缓冲、不支持无锁多生产者、flush()不可靠；需设计L1（线程局部无锁环形缓冲）、L2（无锁MPSC队列）、L3（io_uring专用I/O线程）三级缓冲。
为什么不能直接用 std::ofstream 做高性能异步写入
因为 std::ofstream 是同步阻塞的，每次 write() 都可能触发系统调用、锁竞争、磁盘寻道；即使开了 std::ios_base::out | std::ios_base::app，也挡不住内核页缓存压力和 write(2) 的调度延迟。真实场景下，单线程每秒写几十万条日志时，它会成为瓶颈，且无法控制缓冲层级。
- 默认不支持无锁多生产者写入 —— 多个线程调用
write()必须加锁，吞吐掉一半以上 - 没有用户态缓冲分级：无法把“热点小数据”先攒在 L1（CPU cache 友好），再批量刷到 L2（内存池），最后交由专用 I/O 线程走
io_uring或libaio提交到 L3（内核页缓存） -
std::ofstream::rdbuf()->pubsync()不可靠：它只保证 libc 缓冲区清空，不保证落盘，也不等fsync()
三级缓冲区该怎么分层设计（L1/L2/L3 各自职责）
三级不是越多越好，而是按访问频率、生命周期、线程模型切分责任：L1 要零分配、无锁、CPU cache line 对齐；L2 要支持跨线程安全移交；L3 是唯一与内核交互的出口，必须能批处理、可取消、带错误回滚。
-
L1（per-thread ring buffer）：每个写入线程独占一块
alignas(64) char[4096]，用原子索引推进，不涉及任何锁或内存分配；满时原子移交整块给 L2 -
L2（lock-free MPSC queue）：用
moodycamel::ConcurrentQueue或自研atomic_uintptr_t+ hazard pointer 实现，只收 L1 交来的固定大小 buffer 指针，不做拷贝 -
L3（dedicated io thread +
io_uring）：I/O 线程循环调用io_uring_submit()，把 L2 中的 buffer 批量提交；成功后回调释放内存，失败则重试或降级到writev()
注意：io_uring 在 Linux 5.11+ 才稳定支持 IORING_OP_WRITEV 批量写，老内核得 fallback 到线程池 + writev()，否则会卡住。
io_uring 提交写请求时最常踩的坑
不是把 buffer 丢进去就完事了 —— io_uring 对内存生命周期、buffer 对齐、submission queue 空间极其敏感，错一点就 EINVAL 或静默丢数据。
- buffer 必须是 page-aligned（
posix_memalign(..., 4096, ...)），否则IORING_OP_WRITEV直接返回-EINVAL - 每个
io_uring_sqe提交前，必须确保对应的io_uring_cqe已被上一次完成消费，否则 submission queue 满导致阻塞 - 不要在回调里直接
free()buffer：需用io_uring_prep_writev()的user_data字段携带 allocator handle，让 I/O 线程统一回收 - 没调
io_uring_register_buffers()就用 fixed buffer？会触发IORING_SETUP_IOPOLL模式下的 kernel panic（某些旧发行版）
如何让 C++ 类接口既高效又不易误用
暴露裸指针或 raw buffer 给用户，等于邀请崩溃；但全包一层 std::string 又废性能。关键是在类型系统里把「所有权」和「生命周期」编码进去。
- 提供
write(std::string_view)和write(const char*, size_t)重载，内部统一转成 L1 的 memcpy，禁止用户传栈变量地址（L1 buffer 生命周期短于调用栈） - 不提供
flush()同步接口；只提供try_flush()（非阻塞尝试提交 L2 到 L3）和wait_until_drained()（仅测试/退出时用） - 析构函数必须调用
wait_until_drained()并等待 L3 完成，否则未提交的 buffer 会泄漏；但要设超时（如 5s），避免进程卡死 - 禁用拷贝构造；移动构造需原子接管 L2 queue 的 ownership，并重置原对象的 L1 索引
真正难的不是写完，是让别人接手维护时不改出 use-after-free —— 所以 L1 的 buffer 指针永远不外泄，所有写入路径都经过类内封装的 append_to_l1()，哪怕只是加个换行符。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
