必须显式指定std::ios::binary标志,否则文本模式会进行换行符转换(\n↔\r\n)和空字符截断,导致二进制数据损坏;read()/write()只接受char*和字节数,需配合reinterpret_cast、sizeof及gcount()校验,结构体须满足标准布局且无指针成员。

用 std::fstream 以二进制模式打开文件,否则读写会出错
文本模式默认做换行符转换(\n ↔ \r\n)和空字符截断,二进制数据一旦被误判为控制字符或结尾,就会损坏。必须显式指定 std::ios::binary 标志:
std::fstream file("data.bin", std::ios::in | std::ios::out | std::ios::binary);
- 只读用
std::ios::in | std::ios::binary,只写用std::ios::out | std::ios::binary - 不要混用
std::ios::ate和std::ios::app:前者定位到末尾但允许任意位置读写,后者强制追加且忽略seekp - Windows 下不加
binary会导致read()提前终止——遇到\x1A(EOF 字符)就停
read() 和 write() 只认 char* 和字节数,别传结构体地址就完事
这两个函数不理解类型,只按字节搬运。直接传 &my_struct 是常见错误,前提是结构体满足“标准布局”且无虚函数、无非 POD 成员:
struct Header { uint32_t size; uint16_t version; }; // OK
struct Bad { std::string name; }; // ❌ 不行,内部有指针
- 写结构体前先用
static_assert(std::is_standard_layout_v<t> && std::is_trivially_copyable_v<t>)</t></t>检查 - 跨平台时注意结构体对齐:
#pragma pack(1)或[[gnu::packed]]防止填充字节干扰 - 读取后务必检查
gcount()返回值,它告诉你实际读了多少字节,fail()可能滞后
读写浮点数、整数要小心字节序,别假设本地就是小端
直接 write(&x, sizeof(x)) 写 float 或 int32_t,在不同架构上可能无法互通。网络序(大端)是常见约定:
- 写前转大端:
uint32_t net_size = htonl(my_size); file.write((char*)&net_size, sizeof(net_size)); - 读完转回主机序:
uint32_t host_size = ntohl(net_size); -
htonl/ntohl对uint32_t有效,htons/ntohs对uint16_t;C++23 起可用std::byteswap,但需自行判断平台字节序 - 如果只是本地存取、不跨平台,跳过这步更简单——但得明确知道这个决定的代价
关闭前记得 flush(),尤其用 write() 后立即 seekg() 容易读到旧数据
std::fstream 的读写缓冲区是分开维护的,write() 后不刷新,seekg() 切换到读模式可能看不到刚写的内容:
- 安全做法:写完调
file.flush(),再file.seekg(0) - 或者统一用
std::ios::in | std::ios::out | std::ios::binary打开,避免切换模式 - 析构时自动 flush,但异常路径下可能没机会执行——显式
close()更可控 - Linux 下
strace可验证是否真写入磁盘:write(3, "\x01\x00\x00\x00", 4)这类系统调用才可靠
二进制文件操作真正麻烦的不是语法,而是隐式假设:字节对齐、内存布局、字节序、缓冲区状态——每个都可能在某个环境里突然崩掉。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











