存档结构必须带版本号字段，否则旧存档遇结构微调将解析失败或内存错乱；建议在开头固定写入4字节version，按破坏性变更递增，并显式逐字段序列化、新增字段设默认值且可降级忽略，同时覆盖跨版本读取测试。

存档结构必须带版本号字段

不加版本号的存档，等于没留退路。读取时一旦结构微调（比如新增一个 health 成员），旧存档直接解析失败或内存错乱，玩家进度就丢了。

最简方案：在每个存档二进制/文本块开头固定写入 4 字节整数 version，比如 1、2。序列化函数入口先读这个值，再分支处理。

• 别用宏定义版本常量——改了宏但忘了更新已存档文件，照样崩
• 版本号建议从 1 开始，每次破坏性变更（字段删/改类型/重命名）才递增，兼容性变更（如新增可选字段）可不升版
• 如果用 JSON 或 YAML，把 "version": 2 放在根对象第一项，解析时优先检查它

避免直接序列化 class 内存布局

memcpy(&buffer, &obj, sizeof(obj)) 看起来快，实则埋雷：编译器可能加 padding、虚函数表指针位置不固定、成员顺序受 #pragma pack 影响——换编译器或升级 STL 就读不出来。

真正可控的方式是显式逐字段序列化，哪怕多写几行。

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

• 对 std::vector<int></int>，先写长度 size()，再循环写每个 data[i]；别直接写 data() 指针
• 对 std::string，同样先写长度，再写字符数组；别依赖内部 c_str() 布局
• 枚举类型统一转成 int 存，防止不同编译器底层用 char 还是 short 不一致

新增字段必须默认可降级忽略

版本 2 存档多了个 last_checkpoint_x，但版本 1 的加载逻辑不能因此崩溃。核心原则：新字段只读不写，旧版本读到不认识的字段就跳过。

具体怎么做取决于格式：

• 二进制格式：设计字段头（tag-length-value），遇到未知 tag 就按 length 跳过字节
• JSON 格式：用 json.find("last_checkpoint_x") != json.end() 判断是否存在，不存在就用默认值（如 0.0f）
• 关键点：所有新增字段必须有合理默认值，且旧逻辑能安全绕过它继续运行

测试必须覆盖跨版本读取路径

光测“本版本存→本版本读”没用。真问题永远出在“v1 存→v2 读”或“v2 存→v1 读（报错提示要友好）”。

• 手动保留一份 v1 存档文件，每次发版前用新代码加载它，确认不 crash、关键数据（角色血量、位置）正确
• 写个简单脚本，自动生成 v1/v2/v3 的测试存档，跑自动化校验：字段数量、数值范围、结构完整性
• 特别注意浮点数精度——float 和 double 混用会导致看似相同的值在跨版本时被误判为变更

版本兼容不是加个字段号就完事，是每次改存档结构时都得问一句：老玩家打开游戏，还能站在他上次退出的地方吗？

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！