std::async写文件常被误用，因默认策略std::launch::deferred导致同步执行；临时future析构时阻塞等待致程序提前退出；须显式指定async策略并保持future存活。
std::async 写文件为什么常被误用？
std::async 默认启动策略是 std::launch::deferred（延迟执行），不是真正异步——调用 get() 或 wait() 时才同步执行。很多人写完 std::async([]{ write_file(); }) 就以为“后台写了”，结果主线程一退出，临时 std::future 被析构，触发阻塞等待，文件根本没写完程序就结束了。
- 必须显式指定
std::launch::async启动策略 -
std::future对象必须存活到写入完成，不能是临时量 - 文件写入本身是阻塞 I/O，
std::async只是把阻塞挪到另一个线程，不解决系统级 I/O 瓶颈
auto fut = std::async(std::launch::async, [] {
std::ofstream f("log.txt", std::ios::app);
f << "done at " << time(nullptr) << "\n";
});
// 必须保留 fut，比如存为成员变量或全局 future<void>用 std::thread + std::ofstream 安全写文件要注意什么？
std::ofstream 不是线程安全的，但每个线程独占一个对象就没问题；关键是资源生命周期管理。
- 线程函数里必须按值捕获或移动
std::ofstream，不能传引用或指针到栈上对象 - 如果要写同一文件，需加锁（如
std::mutex），但会串行化，失去并发意义 - 更稳妥的做法：每个异步任务写独立文件，或用
std::stringstream先拼好内容再一次性写入
std::thread t([data = std::move(buffer)]() mutable {
std::ofstream f("out_123.bin", std::ios::binary);
f.write(data.data(), data.size());
});
t.detach(); // 注意：detach 后无法捕获异常，建议 join 或用 thread pool
Windows 上用 WriteFile + OVERLAPPED 真正异步？
Windows 原生异步 I/O（IOCP）才能做到内核级非阻塞写入，但门槛高、易出错。
-
文件必须用
CREATE_FILE_FLAG_OVERLAPPED打开，普通CreateFileA不行立即学习“C++免费学习笔记（深入）”；
OVERLAPPED结构体必须在 I/O 完成前一直有效（不能是栈变量且未保证生命周期）WriteFile返回false且GetLastError() == ERROR_IO_PENDING才算真正异步启动；否则是同步完成单次小写入（<1MB）用 IOCP 反而更慢，上下文切换开销大于收益
多数场景下，用线程池 + 阻塞写入比手撸 IOCP 更可靠、更易调试
推荐方案：基于 std::jthread + RAII 的轻量异步写入类
C++20 std::jthread 自动 join()，配合移动语义和 lambda 捕获，能规避大部分生命周期陷阱。
- 把文件路径和内容打包进 lambda，避免外部变量悬空
- 用
std::error_code捕获std::filesystem或std::ofstream错误，别依赖异常 - 若需回调，传
std::function<void(bool ok)>，但注意它也要按值捕获
class AsyncWriter {
std::jthread t;
public:
AsyncWriter(std::string path, std::string content)
: t([path = std::move(path), content = std::move(content)] {
std::ofstream f(path, std::ios::app);
if (f) f << content << "\n";
}) {}
};
真正难的不是“怎么启动异步”，而是“怎么确保写入成功、错误可观察、资源不泄漏”。很多项目卡在日志异步写崩了却没报错，最后发现是 std::ofstream 构造失败后静默跳过——得检查 f.is_open() 和 !f.fail()。
