std::format 不能直接写入文件流，必须先格式化为字符串再写入；这是常见误区，因其设计仅返回格式化后的字符串，不支持流式输出。
std::format 不能直接写入文件流，必须中转为字符串
这是最常踩的坑：很多人以为 std::format 能像 fmt::print 或 std::cout 那样直接输出到流，但 C++20 的 std::format 只返回 std::string（或 std::wstring），不提供流式重载。它本质是「格式化生成字符串」，不是「格式化并输出」。
所以正确路径只能是：先用 std::format 构造字符串 → 再用 std::ofstream 或 std::ostream& 写入。
- 错误写法：
out —— 编译失败（除非你手动重载了operator） - 正确写法：
out 是可行的，但仅因std::string有默认流插入重载；本质仍是两步 - 注意：
std::format返回的是临时std::string，生命周期到语句结束，适合直接传给流，但不适合保存引用
写入文件时推荐用 std::ofstream::open() 显式指定 utf8（尤其 Windows）
Windows 下默认 std::ofstream 以 ANSI 编码打开文件，而 std::format 生成的是 UTF-8 字符串（C++20 要求），直接写入会导致中文乱码。Linux/macOS 通常默认 UTF-8，问题不明显，但跨平台必须处理。
- Windows 上安全做法：用
std::ofstream out("log.txt", std::ios::out | std::ios::binary)+ 手动写入 BOM（可选）+ 确保终端/编辑器用 UTF-8 解码 - 更可靠方案：改用宽字符路径 +
std::wofstream+std::format的宽版本std::wformat，但需确保 locale 设置正确（如std::locale("zh-CN.UTF-8")在 Linux 可行，Windows 需"Chinese_China.65001"） - 简单跨平台回避方案：坚持用
std::ofstream+std::format+ UTF-8 字符串，并在文件开头写入\xEF\xBB\xBF（UTF-8 BOM），部分编辑器会识别
性能敏感场景慎用 std::format 拼接后写入大文件
每次调用 std::format 都分配堆内存构造新 std::string，若循环写入成千上万行日志，会产生大量短生命周期字符串，触发频繁小内存分配/释放，比直接用 std::ostream 插入（如 out ）慢 2–5 倍（实测 clang 15 + libc++）。
- 高频写入建议：只对需要复杂模板控制的字段用
std::format，其余用原生流操作 - 例如：
out - 若必须全用
std::format，可预先 reserve 字符串缓冲区（但std::format不支持传入 buffer，只能靠后续std::string::reserve()优化后续拼接）
std::format 格式字符串里的转义和流操作符冲突要小心
std::format 的语法和 std::ostream 的操作符（如 std::endl、std::setw）完全无关，混用会出错。比如想换行，不能写 std::format("a{}\n", x) 然后期望自动 flush——\n 就是普通字符，不会触发流行为。
- 换行必须显式写
"\n"或R"( )"
，且写入文件时依赖你是否调用out 或在 format 字符串里包含它 - 制表、对齐等需用
std::format自身语法：std::format("{:5}", s, n)，而不是std::left - 常见误写：
out —— 编译失败，因为std::endl不是可格式化的类型
实际写入文件的最小可靠示例：
std::format
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
