PvZ-Portable项目致力于实现《植物大战僵尸》的全平台互通。针对原版游戏存档依赖内存转储而无法跨架构使用的痛点，本文深入剖析了全新v4存档格式的设计原理，通过序列化技术实现了跨平台无损存档，解决了移植项目中的关键兼容性难题。
智能速览
原版存档机制依赖内存转储，存在严重的跨架构兼容性缺陷。
设计全新的v4存档格式，采用TLV变体结构确保版本兼容性。
引入状态隔离机制修复音频子系统不匹配导致的崩溃问题。
实施双格式共存策略，优先读取v4文件以平滑过渡。
调整存档清理逻辑，仅在关卡结束时删除，防止意外崩溃坏档。
提供Python转换工具，支持查看与双向编辑存档数据。
精华内容
深入剖析v4存档格式的设计原理，看技术如何打破硬件壁垒，实现真正的跨平台游戏体验。
原版存档缺陷
原版《植物大战僵尸》的存档机制极为简单粗暴，直接通过 `memcpy` 将内存对象转储至硬盘。这种“内存快照”方式虽然对单一闭源平台效率极高，但对跨平台移植却是灾难。
由于不同架构（如 x86 与 ARM）和位宽的内存布局差异，原版存档无法在异构系统间互通，导致 Linux 存档无法在 Windows 或 Switch 上读取。
v4格式设计
为解决互通性，设计了 PVZP_SAVE4（v4）格式。文件由 24 字节 Header 和紧随其后的 Chunks 组成。Chunk 内部采用 TLV（Type-Length-Value）变体思想，为每个属性分配 Tag ID。
这种设计允许游戏未来增减字段而不破坏旧存档兼容性，实现了跨 ISA、编译器及位宽的稳定互通。
兼容性难题
开发中曾遇到跨架构崩溃问题，经排查并非内存布局错误，而是音频子系统支持状态不匹配。Board 对象中的 `mMusicDisabled` 字段在异构环境下读取导致断言失败。
解决方案是在序列化层引入运行时状态隔离，读取此类反映硬件状态的字段后直接丢弃，不修改内存真实状态，从而避免崩溃。
双格式与安全
为保证平滑过渡，项目采用双格式共存策略，保存时同时生成 `.v4` 和 `.dat` 文件。加载时优先识别 `.v4` 格式。
此外，优化了存档清理逻辑，从“加载关卡即删除”改为“关卡结束时才删除”。这一改动虽然理论上允许通过杀进程重试，但优先保障了玩家在游戏意外崩溃时不丢失进度的权益。
v4存档格式的诞生，不仅解决了技术层面的互通难题，更让经典游戏得以摆脱原生平台的束缚。配合Python转换工具，玩家与开发者能更自由地管理游戏数据。期待更多开源项目能通过类似的架构创新，延续经典游戏的生命力。
