std::basic_osyncstream通过缓冲+原子刷新解决多线程乱序输出：写入先缓存，析构或emit()时加锁一次性刷出，确保提交到下游流的原子性；使用时需保证对象生命周期，不可拷贝，可移动，避免提前退出作用域导致缓冲丢失。
std::basic_osyncstream 为什么能解决多线程乱序输出
它本质是给 std::ostream 加了一层同步代理：每次写入先缓存到本地缓冲区，等析构或显式 emit() 时，才用互斥锁保护、一次性刷到下游流（如 std::cout）。这样避免了多个线程交替写入同一底层流导致的字符交错。
关键点在于「原子性刷新」——不是锁住整个写操作过程（那会严重拖慢性能），而是把“格式化+缓冲”放开并发，“提交到真实流”这一步强制串行。
怎么正确使用 std::osyncstream（C++20）
直接构造时传入目标流，用法和 std::ostream 几乎一致，但要注意生命周期：
- 必须确保
std::osyncstream对象在作用域内完成所有写入，否则缓冲内容可能丢失（未析构就退出作用域，C++标准不保证自动 flush） - 不能返回局部
std::osyncstream的引用或指针；它不可拷贝，仅可移动 - 若需提前提交，调用
emit()，它会加锁并刷出当前缓冲区，之后继续写入仍走新缓冲
示例：
立即学习“C++免费学习笔记（深入）”；
void log_thread(int id) {
std::osyncstream sync_out{std::cout};
sync_out << "Thread " << id << " started\n";
sync_out.emit(); // 确保这行立即可见
sync_out << "Thread " << id << " finished\n"; // 析构时自动 emit
}
常见误用：和 std::cout 混用导致失效
如果一部分日志用 std::osyncstream，另一部分还直接写 std::cout，那么乱序问题依然存在——因为 std::osyncstream 只保护自己刷出的那一段，无法约束其他对 std::cout 的直接访问。
必须统一出口：
- 所有线程都只通过
std::osyncstream{std::cout}输出 - 或者封装一个全局同步日志函数，内部统一用
std::osyncstream - 避免在同一个程序里同时出现
std::cout 和std::osyncstream{...}
替代方案对比：std::osyncstream vs 手动 std::mutex
手动锁 std::cout 虽然也能防乱序，但粒度太粗：一次 可能触发多次 operator 调用，锁住整个表达式执行期间，容易阻塞其他线程。而 std::osyncstream 允许各线程并行格式化、仅在最终提交时竞争锁，吞吐更高。
但要注意：std::osyncstream 不解决「逻辑顺序错乱」——比如你期望 A 线程的日志总在 B 线程之前，它不保证这点；它只保证每条完整日志字符串不被截断或穿插。
真正容易被忽略的是：它的缓冲是 per-stream 实例的，不同 std::osyncstream 对象之间没有顺序约束；如果你创建了两个分别包装 std::cout 的对象，它们的 emit() 仍可能交叉——所以别这么干。
