必须显式指定std::ios::binary标志,否则ofstream按文本模式处理导致换行符转换和偏移错乱;写二进制须用write()配合reinterpret_cast,不可用

直接用 ofstream 默认是文本模式,写二进制会出错——必须显式指定 std::ios::binary 标志,否则换行符被悄悄转换、文件末尾可能被截断。
必须加 std::ios::binary 标志
这是最关键的一步。不加这个标志,哪怕你写的是 char* 或 uint8_t 数组,ofstream 仍按文本流处理:Windows 下 '\n' 会被替换成 "\r\n",读写偏移也可能错乱。
正确写法:
std::ofstream file("data.bin", std::ios::out | std::ios::binary);
if (!file.is_open()) {
// 处理错误
}
常见错误写法(危险):
立即学习“C++免费学习笔记(深入)”;
-
std::ofstream file("data.bin");—— 没有binary,纯文本模式 -
std::ofstream file("data.bin", std::ios::out);—— 同上,out不隐含binary
写原始内存要用 write(),别用
是格式化输出操作符,只适合字符串、数字等类型,且会做类型转换和插入分隔符;写二进制必须用 write() 直接吐出字节块。
示例:写一个 int 和一个浮点数组
int x = 42;
float arr[] = {1.1f, 2.2f, 3.3f};
file.write(reinterpret_cast(&x), sizeof(x));
file.write(reinterpret_cast(arr), sizeof(arr));
注意点:
- 必须用
reinterpret_cast转类型,write()第一个参数是const char* -
sizeof()对数组有效,但对指针无效(传参后退化为指针) - 结构体可直接
write(),但含指针或虚函数时不可移植(仅限 POD 类型)
写完记得 close() 或让对象析构,否则缓冲区可能没刷出
ofstream 内部有缓冲区,默认不会每写一次就落盘。如果程序异常退出、或没显式关闭,最后一段数据可能丢失。
推荐做法:
- 让
ofstream对象作用域自动结束(RAII),析构时自动close() - 若需提前确认写入完成,调用
file.close(),之后检查file.fail() - 避免只靠
file.flush()——它只清缓冲区,不保证磁盘写入完成
小陷阱:file.is_open() 在 close() 后返回 false,但 fail() 可能在 close() 时才暴露底层 I/O 错误(如磁盘满)。
跨平台写二进制要小心字节序和结构体对齐
上面的写法在本机读写没问题,但若文件要给其他平台(比如嵌入式设备、Python 脚本)读,就得额外处理:
- 整数默认按本机字节序(小端/大端),需统一为网络序(
htons/htonl)或手动拆字节 - 结构体成员可能因编译器对齐填充而“多出”字节,用
#pragma pack(1)或alignas(1)强制紧凑布局 -
sizeof(int)不一定是 4 字节(虽然绝大多数情况是),建议用int32_t等固定宽度类型
真正需要跨平台时,光靠 ofstream + write() 不够,得配套协议定义和序列化逻辑。
最常被跳过的其实是 binary 标志和 reinterpret_cast 这两步,一漏就写成“看似正常、实则损坏”的文件——尤其在 Windows 上测试时容易蒙混过关,换到 Linux 就发现读不出来。










