直接用 fwrite 写结构体常出错，因编译器默认填充 padding 字节，fwrite 原样拷贝导致读取错位；结构体含指针、std::string 等非 POD 成员时写入的是地址而非数据；跨平台还面临对齐策略与字节序不一致问题。
结构体直接 fwrite 写入文件为什么常出错
直接用 fwrite 把结构体写进二进制文件，看似最简单，但实际几乎必然出问题——除非你全程严格控制内存布局。根本原因在于：C++ 编译器默认按自然对齐填充字节，sizeof(MyStruct) 不等于各成员大小之和，而 fwrite 只管按字节拷贝整个对象内存块，读取时若目标平台/编译器对齐策略不同，或结构体被修改过，就会读出错乱值。
常见错误现象包括：int 字段读出来是极大负数、float 变成 nan、字符串首地址非法访问。尤其跨平台（比如 Windows x64 编译后在 Linux ARM 上读）或升级编译器后极易复现。
- 必须显式禁用填充：用
#pragma pack(1)或alignas(1)（C++11 起），且所有参与序列化的结构体都得统一 - 结构体不能含指针、引用、虚函数、非 POD 类型（如
std::string、std::vector），否则fwrite写进去的只是指针地址，不是真实数据 - 读写两端的编译器、ABI、字节序（endianness）必须一致；若需跨大小端，得手动翻转字段
如何安全封装读写逻辑：只允许 POD 结构体 + 显式对齐
封装的关键不是“让任意结构体都能用”，而是“让符合约束的结构体读写行为可预测、可测试”。推荐做法是定义一个模板函数，强制检查类型是否为标准布局（standard-layout）且无用户定义构造/析构：
template <typename T>
static_assert(std::is_standard_layout_v<T> && std::is_trivially_copyable_v<T>,
"T must be standard-layout and trivially copyable");再配合 static_assert 检查对齐是否为 1：
立即学习“C++免费学习笔记（深入）”；
static_assert(alignof(T) == 1, "T must have alignment 1");
这样就能在编译期拦住不合规类型。实际读写函数只需两行：
bool write_to_file(const T& obj, const char* path) {
FILE* f = fopen(path, "wb");
if (!f) return false;
size_t r = fwrite(&obj, sizeof(T), 1, f);
fclose(f);
return r == 1;
}
<p>bool read_from_file(T& obj, const char<em> path) {
FILE</em> f = fopen(path, "rb");
if (!f) return false;
size_t r = fread(&obj, sizeof(T), 1, f);
fclose(f);
return r == 1;
}
#pragma pack 的作用范围与陷阱
#pragma pack 是最常用也最容易误用的对齐控制方式。它只影响其后声明的结构体，不会自动恢复之前的对齐设置，容易污染后续头文件。
- 必须成对使用：
#pragma pack(push, 1)开始，#pragma pack(pop)结束，避免影响其他模块 - 不要在全局头文件顶部写
#pragma pack(1)，而应在具体结构体前后包裹 - Clang 和 GCC 支持
__attribute__((packed))，但它是附加在 struct 定义上的，比#pragma更局部、更安全 - MSVC 中
#pragma pack默认影响所有后续 struct，即使没写push/pop，但行为不跨平台，务必显式配对
示例正确写法：
#pragma pack(push, 1)
struct Header {
uint32_t magic;
uint16_t version;
uint8_t flags;
};
#pragma pack(pop)读写失败时怎么快速定位是结构体还是文件问题
当 fread 返回值不为 1，不要直接假设是结构体定义错了。先做三件事：
- 用
stat（Linux/macOS）或dir（Windows）确认文件大小是否等于sizeof(T)；不等说明写入中途失败或被截断 - 用
hexdump -C file.bin | head查看前几个字节，对照结构体字段的十六进制预期值（比如magic是否真写成了0x464F4F54） - 在写入后立即用
fseek(f, 0, SEEK_SET); fread(...)在同一进程内重读，排除文件关闭/缓存问题
如果本地读写正常、跨机器失败，大概率是字节序或对齐不一致；如果连本地都读不对，优先检查 #pragma pack 是否生效（打印 sizeof(Header) 和各字段 offsetof 验证）。
真正麻烦的是结构体嵌套——只要其中任一子结构体没加 packed，整个链就失效。这种地方没法靠编译器警告，只能靠单元测试覆盖所有字段赋值+读写校验。
