c++oding="utf-8" ?>
std::osyncstream通过绑定独占std::basic_syncbuf实现线程安全日志输出，写入先缓存至线程本地缓冲区，flush或析构时原子刷入目标流，避免多线程写同一ostream导致的内容交织；但仅保证单行不撕裂，不保证全局顺序。
std::osyncstream 为什么能解决日志交织
因为 std::osyncstream 在底层绑定了一个独占的 std::basic_syncbuf，每次写入先缓存到线程本地缓冲区，flush() 或析构时才原子地刷到目标流（比如 std::cout）。这避免了多个线程直接往同一个 std::ostream 写时因缓冲区竞争、换行符截断、小写操作非原子导致的内容穿插。
注意：它不保证“日志行顺序”，只保证“单行不被撕裂”。如果你依赖时间戳或 ID 的严格全局顺序，还得配合外部同步（如 std::mutex）。
怎么正确构造和使用 std::osyncstream
别直接传 std::cout 给它然后长期持有——std::osyncstream 构造时会接管底层 std::syncbuf 的所有权，而 std::cout 的 rdbuf() 默认不是可交换的同步缓冲区。常见错误是：
- 用
std::osyncstream{std::cout}在多线程中反复构造 → 触发未定义行为（C++20 标准明确要求底层streambuf必须支持syncbuf语义） - 忘记让
std::osyncstream自动析构 → 缓冲内容可能滞留不输出
正确做法是：先为 std::cout 显式设置一个 std::syncbuf，再用它构造 std::osyncstream：
std::syncbuf sync_buf{std::cout.rdbuf()};
std::cout.rdbuf(&sync_buf); // 让 cout 输出走 syncbuf
// 线程内：
std::osyncstream os{&sync_buf};
os
<h3>std::osyncstream 的性能和兼容性坑</h3>
<p>它不是银弹。每行日志都触发一次缓冲区锁 + 刷出，高并发下容易成为瓶颈。实测在百万级日志/秒场景，比带锁的 <code>std::scoped_lock</code> + <code>std::cout</code> 还慢 10%–30%。</p>
- C++ 标准库实现差异大：
libstdc++（GCC）从 12.1 起完整支持；libc++（Clang）需 15+ 且默认不启用__cpp_lib_syncbuf宏；MSVC 2019 16.11+ 支持但有早期版本 bug - 不能和
std::endl混用：std::endl会额外调用flush()，而std::osyncstream析构时又 flush 一次，造成冗余 - 不支持格式化操纵器链式调用的“延迟求值”：比如
os 没问题，但 <code>os 在某些 libstdc++ 版本会丢精度
替代方案比对：什么时候不该用 std::osyncstream
如果日志量极大、且允许少量乱序，用无锁环形缓冲区（如 boost::lockfree::spsc_queue）+ 单独日志线程更稳；如果只是想避免 printf 风格的 std::cout 交织，且编译器不支持 C++20，老老实实用 <code>std::mutex + std::scoped_lock 更可靠。
真正适合 std::osyncstream 的场景很窄：C++20 环境、日志频率中等（
最容易被忽略的一点：它只同步“输出动作”，不处理日志内容本身的线程安全——比如你传入的 std::string 如果是共享的、且被其他线程修改，照样崩。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
