C++中std::ofstream默认文本模式可跨平台自动转换换行符：Windows转为\r\n，Linux/macOS保持\n；禁用缓冲或使用binary模式会破坏该机制，导致^M等问题。
写入文件时换行符不一致导致跨平台显示异常
Windows 用 \r\n，Linux/macOS 用 \n；直接写死换行符会导致文件在其他系统里显示为“一行”或带 ^M 符号。C++ 标准库的文本模式（默认）会自动做转换，但前提是：你得用 std::ofstream 以文本模式打开，且**不调用 os.rdbuf()->pubsetbuf(nullptr, 0) 或其他禁用缓冲/强制二进制行为的操作**。
常见错误现象：
- 在 Windows 编译、Linux 运行时，文件每行末尾多出
\r，vim 显示^M - 用
std::ios::binary打开文件后，\n写进去就是纯\n，不会转成\r\n—— 这不是 bug，是 binary 模式的设计行为 - 手动拼接
"\r\n"写入，结果在 Linux 下产生多余回车
std::ofstream 默认就是跨平台换行兼容的
只要你没显式指定 std::ios::binary，std::ofstream 就工作在文本模式，底层 I/O 会按平台规则自动映射 \n → 对应系统换行序列。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 始终用默认构造（不带
std::ios::binary）：std::ofstream os("log.txt"); - 写入时统一用
\n：os 或 <code>os - 避免混用 C 风格写法：
fprintf(fp, "%s\n", str.c_str())也 OK，但前提是fopen("x.txt", "w")—— 不能用"wb" - 如果用了
std::ios::ate或std::ios::app，不影响换行转换，它们和文本/二进制模式正交
需要手动控制换行符的少数场景
比如生成 HTTP 响应头、固定协议格式、或必须输出 LF-only 的配置文件（即使在 Windows 上），这时才该绕过自动转换。
做法是：用 binary 模式打开 + 手动写入目标换行符：
std::ofstream os("out.bin", std::ios::binary);
os << "Content-Type: text/plain\n";
os << "X-Mode: strict\n";
// 注意：这里写 \n，不会被转成 \r\n —— 因为是 binary 模式
但要注意：
- binary 模式下，
和 <code>.write()行为一致，无格式化（比如os 仍会写字符串 "123"，不是字节 0x7B） - 如果真要写原始字节，请用
.write(reinterpret_cast<const char>(&x), sizeof(x))</const> - 跨平台生成“给 Linux 用的脚本”，就固定写
\n并用 binary 模式；别指望文本模式帮你“反向转换”
第三方库或跨平台抽象层里的坑
像 fmt::print、spdlog、boost::filesystem 的日志写入，默认都依赖底层 std::ofstream 行为。但有些封装会悄悄设 binary 模式（例如某些 ZIP 库的文本写入函数），或者把 string_view 直接 dump 进去。
排查方法：
- 检查你调用的 API 文档是否注明 “binary mode” 或 “no newline translation”
- 用
xxd out.txt | head（Linux/macOS）或Get-Content out.txt -Encoding Byte（PowerShell）看实际字节 - 如果发现该有
\r\n的地方只有\n，十有八九是上游开了 binary 模式，得换接口或自己 wrap 一层文本流
最保险的做法，永远是：确认打开方式、确认写入内容、用十六进制工具验证输出 —— 别信文档，更别信“应该没问题”。
