std::ofstream不能跨线程共用，因其内部缓冲区、文件位置指针和流状态（如good()/fail()）均非原子操作，多线程并发调用operator<<或write会导致数据错乱、覆盖、截断或崩溃。
并发写文件导致的损坏，本质是多个线程直接共享 std::ofstream 或同一文件描述符，绕过同步机制——这不是“偶尔出错”，而是必然破坏数据一致性。关键不在于事后修复，而在于第一时间堵住非线程安全的写入路径。
为什么 std::ofstream 不能跨线程共用
std::ofstream 对象内部维护缓冲区、文件位置指针和流状态（good()/fail()），这些都不是原子操作。两个线程同时调用 operator 或 <code>write()，会导致：
- 写入位置错乱：一个线程刚写完 5 字节，另一个线程覆盖了第 3 字节，中间出现字节撕裂
- 缓冲区竞争：
flush()被其中一个线程触发，但另一个线程的未刷新数据被丢弃或重复写入 - 流状态污染：一个线程触发
failbit（如磁盘满），另一个线程读到错误状态却继续写，结果静默失败
即使加锁保护 operator，也不能解决底层系统调用（如 <code>write(2)）的原子性边界问题——POSIX 只保证单次 write 小于 PIPE_BUF 的原子性，对普通文件无此保证。
正确做法：写入必须隔离或序列化
不要试图“加个 mutex 保护 ofstream 对象”就完事。真正安全的方案只有两类：
立即学习“C++免费学习笔记（深入）”；
-
每个线程独占一个文件：用线程 ID 或时间戳生成唯一文件名，例如
"log_std::this_thread::get_id().txt"；适合日志归档、批量导出等场景 -
所有写入经由单一线程中转：用
std::queue+std::mutex+std::condition_variable构建生产者-消费者队列，由专用 I/O 线程串行落盘；适合需要严格顺序（如审计日志）的场景
避免使用全局 std::ofstream 静态对象或单例——它们在多线程下初始化本身就有竞态风险（std::call_once 可缓解，但不解决后续写入问题）。
如何快速确认是不是并发写导致损坏
损坏特征比崩溃更隐蔽，但有迹可循：
- 文件内容出现“跳跃式”乱码：比如某段文本突然中断，紧接着是另一段完全无关的内容，中间没有换行或分隔符
- 结构化数据（JSON/CSV）校验失败：
JSON.parse()报 “unexpected token”，但手动检查发现只是某一行末尾混入了其他线程的日志前缀 - 用
hexdump -C file.txt | head -20查看开头字节，若发现本该是 ASCII 的位置出现00或高位字节（如80 ff），大概率是不同线程写入时偏移错位
临时验证方法：把所有 ofstream 写入点替换成 std::cerr ，观察终端输出是否交错混乱——如果终端都乱，文件必然乱。
libtorch 或其他第三方库的隐式文件写入要特别小心
某些库（如 libtorch 的 torch::save()、OpenCV 的 cv::imwrite()）内部会打开文件并写入。它们通常不声明线程安全性，实际也极少做同步处理。常见坑：
- 多个线程同时调用
torch::save(model, "model.pt")→ 文件被反复截断重写，最终只剩最后一个线程写入的碎片 - 用相同文件名调用
cv::imwrite()→ 后写入的图像覆盖前一个，但若写入中途被中断，可能得到尺寸错误的 JPEG（头信息与像素数据不匹配）
对策：强制为每次调用生成唯一路径，例如 "output_" + std::to_string(counter++) + ".jpg"，或用 std::lock_guard 包裹整个保存逻辑（注意：仅限你控制调用点的场景，不能依赖库内部行为）。
真正难排查的不是“谁在写”，而是“谁以为自己在安全写”。很多损坏源于一个看似无害的全局日志函数，它内部持有一个 std::ofstream 并用 std::mutex 保护——但忘了 flush() 和 close() 也需同步，或没处理异常退出导致的流状态残留。这类细节，在压力测试下才会暴露。
