std::syncstream通过构造时自动加锁、析构或emit时解锁，确保同一时刻仅一个线程写入底层ostream，从而避免多线程输出乱序。
std::syncstream 为什么能避免多线程输出乱序？
因为 std::syncstream 在构造时会自动获取底层 std::basic_osyncstream 关联的 std::basic_streambuf 的锁（通过 std::mutex），并在整个流生命周期内持有该锁，直到流对象析构或显式调用 emit()。这意味着同一时间只有一个线程能真正写入底层 std::ostream（如 std::cout），从而避免了 std::cout 被其他线程打断导致的交错输出。
注意：它不是对每个 操作加锁，而是对「一次完整表达式求值后的 flush」加锁——这正是日志场景需要的原子性单位（一行日志应完整、不可分割）。
正确构造 syncstream 并用于日志函数
直接使用 std::osyncstream（C++20 中 std::syncstream 是别名）包装 std::cout 或文件流；但必须确保其生命周期覆盖整条日志语句，否则锁提前释放，失去保护作用。
- ✅ 正确：让
std::osyncstream作为临时对象，在单条表达式中完成全部输出 - ❌ 错误：保存为局部变量后多次调用
，或跨函数传递未绑定的流对象 - ⚠️ 注意：
std::osyncstream不可拷贝，仅可移动；也不能绑定到非 const lvalue 引用
void log(const char* msg) {
std::osyncstream(std::cout) << "[LOG] " << msg << '\n'; // ✅ 自动锁 + 自动 flush + 自动析构
}
<p>// 多参数日志（推荐）
template<typename... Args>
void log(const char<em> fmt, Args&&... args) {
std::osyncstream(std::cout) << "[LOG] " << fmt << ": ";
(std::osyncstream(std::cout) << ... << std::forward<Args>(args)) << '\n'; // ❌ 错！多个独立 syncstream
// 正确做法：用一个 syncstream 完成全部输出
}
// 改为：
template<typename... Args>
void log(const char</em> fmt, Args&&... args) {
std::osyncstream s{std::cout};
s << "[LOG] " << fmt << ": " << (std::forward<Args>(args) << ... << "");
s << '\n'; // ✅ 单个 syncstream 对象贯穿全程
}与 std::stringstream / std::ostringstream 混用的陷阱
有人想先格式化再输出，于是用 std::ostringstream 拼接字符串，再用 std::osyncstream 输出——这看似安全，实则引入额外开销且不必要；更危险的是，若在拼接过程中调用了可能抛异常的代码，std::osyncstream 构造失败会导致锁未获取，而后续仍尝试输出。
立即学习“C++免费学习笔记（深入）”；
- 不要手动管理缓冲区：避免
std::ostringstream+str()+std::osyncstream - 避免在
std::osyncstream构造前做复杂计算（尤其是可能抛异常的操作） - 若需格式化控制（如时间戳），应在
std::osyncstream内部直接完成，例如调用std::format（C++20）后一并输出
void log_with_time(const char* msg) {
auto now = std::chrono::system_clock::now();
std::time_t t = std::chrono::system_clock::to_time_t(now);
std::osyncstream s{std::cout};
s << "[" << std::put_time(std::localtime(&t), "%H:%M:%S") << "] "
<< "[LOG] " << msg << '\n';
}性能和兼容性注意事项
std::osyncstream 的锁粒度是 per-stream，不是 per-thread，所以高并发下可能成为瓶颈；但它比手动加 std::mutex 更轻量（无用户态锁竞争逻辑，依赖底层 streambuf 的同步机制）。另外，不是所有标准库实现都完全支持 C++20 syncstream（如早期 libstdc++ 11.x 需要 -D_GLIBCXX_CONCEPTS，MSVC 2019 16.10+ 才稳定支持）。
- 编译时确认：用
__cpp_lib_syncstream宏检测支持情况 - 生产环境建议封装一层日志类，内部持有一个
std::osyncstream绑定到std::ofstream，避免频繁构造/析构std::osyncstream对象 - 如果目标平台不支持，退回到
std::mutex+std::lock_guard包裹std::cout是最直接的等效替代
最易被忽略的一点：syncstream 的线程安全只保证「输出顺序不交错」，不保证日志内容本身的逻辑一致性（比如两条相关日志被不同线程发出，它们的相对顺序仍不确定）。真要保证时序，得靠外部序列号或时间戳，而不是依赖 syncstream。
