存档系统设计:数据模型、序列化、版本迁移、安全写入、加密与云存档
一、存档数据与运行时对象分离
不要直接序列化游戏中的运行时对象(MonoBehaviour、各种管理器)。它们包含大量不需要保存的状态、对 Unity 对象的引用,结构也会随着开发不断变化。
应该定义一套专门的存档数据结构:
[Serializable]public class SaveData{ public int Version = 3; // 存档版本号 public long SaveTime; public PlayerSave Player = new(); public List<ItemSave> Items = new(); public Dictionary<int, int> LevelStars = new(); // 用支持 Dictionary 的序列化库}
[Serializable]public class PlayerSave{ public int Level; public long Gold; public int[] UnlockedSkills;}- 只包含需要保存的纯数据:数字、字符串、ID;
- 引用其他对象时保存它的 ID,而不是对象本身(物品保存配置 ID,见 背包的配置与实例);
- 保存时从运行时数据生成存档数据,读取时根据存档数据重建运行时状态。
二、序列化格式
| 格式 | 优点 | 缺点 |
|---|---|---|
| JSON | 可读,便于调试;修改结构时容错性好 | 体积较大;Unity 的 JsonUtility 不支持 Dictionary 和多态(见 序列化规则),通常改用 Newtonsoft.Json |
| 二进制(Protobuf、MessagePack 等) | 体积小、读写快 | 不可读,需要工具查看 |
BinaryFormatter | — | 不要使用:有严重的安全隐患,.NET 官方已经弃用 |
格式的原理和对比见 序列化与网络协议。
单机休闲游戏用 JSON 完全足够;数据量大、保存频繁时考虑二进制。
三、版本与迁移
游戏会不断更新,存档的结构也会变:新增字段、修改字段的含义、拆分数据。旧版本的存档必须能被新版本正确读取,否则玩家更新后进度丢失,是最严重的事故之一。
每份存档带上版本号,读取时逐步升级:
SaveData Load(string json){ var raw = JObject.Parse(json); int version = raw.Value<int>("Version");
if (version < 2) MigrateV1ToV2(raw); // v1 → v2:金币从 int 改成了 long if (version < 3) MigrateV2ToV3(raw); // v2 → v3:背包结构调整 raw["Version"] = CurrentVersion;
return raw.ToObject<SaveData>();}- 每一个版本的变化写一个迁移函数,按顺序依次执行,任何旧版本都能升级到最新;
- 新增字段要有合理的默认值;
- 删除字段前先确认迁移已经处理了它的数据;
- 保留一些各个版本的真实存档作为测试用例,每次发版前验证都能正确读取。
四、安全地写入
问题:写入存档的过程中,游戏崩溃、手机没电、进程被杀,文件只写了一半,存档就损坏了。
先写临时文件,再替换:
public static void SafeWrite(string path, byte[] data){ string tmp = path + ".tmp"; string backup = path + ".bak"; File.WriteAllBytes(tmp, data); // 1. 完整写入临时文件
if (File.Exists(path)) File.Replace(tmp, path, backup); // 2. 用临时文件替换正式文件,旧文件留作备份 else File.Move(tmp, path);}- 写临时文件时崩溃:正式存档完好无损;
- 替换是很快的文件系统操作,几乎不会中途失败;
- 个别平台的文件系统可能不支持
File.Replace,可以改为”删除正式文件、再把临时文件移动过去”,并在启动时检查是否残留了未完成替换的临时文件; - 保留上一个版本的备份,读取正式存档失败(校验不通过、解析出错)时,可以回退到备份。
读取时也要做好防御:文件不存在、解析失败、数据明显不合法时,使用备份或给出提示,不能直接崩溃,更不能用空数据覆盖掉原存档。
五、保存的时机
- 关键节点:通关、获得重要道具、完成充值后立即保存;
- 定时自动保存:比如每隔一段时间,且只在数据有变化时(脏标记)才保存;
- 切到后台时保存:移动端在
OnApplicationPause(true)中保存,因为切到后台后进程随时可能被杀死,OnApplicationQuit不一定会被调用(见 移动端的前后台切换)。
异步保存
存档较大时,序列化和写文件可能造成一帧卡顿:
主线程:把当前的数据复制成一份快照(或者直接序列化成字节)后台线程:写入文件关键是写文件期间,主线程继续修改数据不能影响正在写入的那一份,所以要先做快照。同时要避免两次保存同时进行,或者后发起的保存被先发起的覆盖。
六、PlayerPrefs
PlayerPrefs 适合保存少量的设置项:音量、画质、语言、是否看过某个提示。
不适合保存游戏进度:
- 只支持 int、float、string 三种类型;
- 存储的位置因平台而异(Windows 上在注册表中),容量和性能不适合大量数据;
- 很容易被找到和修改。
七、加密与防篡改
单机游戏的存档保存在玩家的设备上,玩家可以修改它(改金币、解锁关卡)。
| 手段 | 作用 |
|---|---|
| 加密(如 AES) | 存档不再是明文,不能直接用文本编辑器修改 |
| 校验(如 HMAC 或带密钥的哈希) | 存档被改动后校验不通过,可以识别出来 |
| 混淆字段、分散存储 | 增加分析的难度 |
局限:密钥必须放在客户端中才能解密,有经验的人可以从程序中把它找出来。所以客户端加密只是提高门槛,挡住普通玩家用工具随手修改,不能真正防住破解。
真正重要的数据必须由服务器保存和校验:付费货币、排行榜成绩、会影响其他玩家的数据。
八、云存档
玩家换手机或者在多台设备上玩时,需要云存档。最大的问题是冲突:
手机 A 离线玩了一段时间,进度:第 30 关手机 B 同时也在玩,已经上传到云端:第 25 关,但多了一个付费角色两者都要上传,以谁为准?| 策略 | 做法 | 问题 |
|---|---|---|
| 以最新的时间为准 | 比较保存时间 | 设备时间可能不准,也可能丢失另一边的进度 |
| 以进度更多的为准 | 比较关卡、等级等 | 不一定能定义”更多” |
| 让玩家选择 | 显示两份存档的摘要(等级、关卡、时间),让玩家决定 | 最安全,常见做法 |
| 合并 | 按字段合并(取最高的关卡、合并已解锁的内容) | 实现复杂,但体验最好 |
此外:
- 存档带上版本计数,每次上传都基于上一次同步的版本,检测到云端已经被其他设备更新过,才进入冲突处理;
- 付费相关的数据不能只依赖存档,要以服务器的购买记录为准,避免玩家因为选错存档而丢失付费内容;
- 上传失败时保留本地数据,网络恢复后重试。
常见追问
存档系统怎么设计? 定义独立的存档数据结构,只包含纯数据和 ID;选择合适的序列化格式;带版本号支持迁移;用临时文件加替换的方式安全写入;在关键节点、定时和切后台时保存。
为什么不直接序列化运行时对象? 运行时对象包含大量不需要保存的状态和引用,结构经常变化,耦合太紧,难以兼容旧版本的存档。
更新版本后怎么兼容旧存档? 存档带版本号,为每个版本的结构变化写迁移函数,读取时依次升级到最新版本;新字段提供默认值;用旧存档做回归测试。
怎么防止写入时崩溃导致存档损坏? 先写入临时文件,完成后再替换正式文件,并保留备份;读取失败时回退到备份。
移动端什么时候保存? 关键节点立即保存,定时自动保存,切到后台时(OnApplicationPause)一定要保存。
存档加密有用吗? 能挡住普通玩家用工具随手修改,但密钥在客户端,不能真正防破解。重要数据必须由服务器保存和校验。
云存档的冲突怎么处理? 用版本计数检测冲突,常见做法是展示两份存档的摘要让玩家选择,或者按字段合并;付费内容以服务器记录为准。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!