游戏叙事与剧情 / 系统课时
新旧存档遇到变量变化怎么办
新旧存档遇到变量变化怎么办
剧情上线后继续改 Ink 变量是常态:会新增字段、调整默认值,甚至重命名旧变量。真正危险的不是“多了一个变量”,而是旧存档携带的状态语义与新脚本不再一致。本节用版本化存档和加载后迁移,把兼容逻辑放在你能控制的边界上,而不是直接修改 Ink 的内部状态 JSON。
学习目标
- 区分新增变量、重命名变量和类型变化的兼容风险
- 给存档增加版本号,并在
LoadJson()后执行明确的迁移 - 知道哪些改动可以补默认值,哪些改动必须做显式数据转换
先按变化类型判断风险
只新增变量时,风险最低。新版本 Ink 中先声明变量,再对旧存档按版本补一个确定的默认值即可。这样兼容行为不依赖旧状态里是否恰好存在该键。
重命名变量和类型变化风险更高。旧存档里的 reputation 不会自动知道它现在叫 trust;一个原来是整数的变量改成字符串,也需要你定义转换规则。对这两类变化,应把“旧语义如何映射到新语义”写成迁移代码。

给存档外壳加版本号
不要直接解析、增删 Ink StoryState JSON 内部字段。它是运行时实现细节,结构可能随 Ink Runtime 演进。更稳妥的方式是在外面包一层你自己的存档对象,记录 saveVersion 和必要的兼容字段。
下面示例假设 v1 使用 reputation,v2 的 Ink 脚本改为 trust,同时新增 has_map。旧版在保存时把关键业务值镜像到了外壳字段 reputation,因此新版本能够明确迁移。
using System;
using Ink.Runtime;
using UnityEngine;
public sealed class InkSaveMigrator : MonoBehaviour
{
[Serializable]
private sealed class SaveEnvelope
{
public int saveVersion;
public string inkStateJson;
// v1 遗留字段:在仍支持 v1 存档期间保留,只用于迁移。
public int reputation;
}
[SerializeField] private TextAsset currentInkJson;
public Story LoadCompatibleStory(string saveJson)
{
SaveEnvelope save = JsonUtility.FromJson<SaveEnvelope>(saveJson);
if (save == null || string.IsNullOrEmpty(save.inkStateJson))
throw new InvalidOperationException("无效存档:缺少 inkStateJson");
Story story = new Story(currentInkJson.text);
story.state.LoadJson(save.inkStateJson);
ApplyPostLoadMigration(story, save);
Debug.Log($"Save migrated: v{save.saveVersion} -> current");
return story;
}
private static void ApplyPostLoadMigration(Story story, SaveEnvelope save)
{
if (save.saveVersion < 2)
{
// 新脚本必须已经声明 VAR trust 和 VAR has_map。
story.variablesState["trust"] = save.reputation;
story.variablesState["has_map"] = false;
}
}
}预期输出:加载一个 saveVersion 为 1 的旧存档后,控制台会输出迁移记录;trust 得到旧 reputation 的值,has_map 被补成 false。
Save migrated: v1 -> current如果旧版本没有在外壳中保存 reputation,就不要为了“兼容”去猜值。更可靠的做法是保留一个能读取旧存档的中间版本,或在发布重命名前先把关键值写入稳定的业务存档字段。
默认值要表达业务含义
新增变量的默认值不能只考虑“代码不报错”,还要考虑旧玩家的剧情语义。例如新版本增加 has_map,如果旧玩家在历史章节中已经必然拿到地图,那么统一补 false 会让剧情倒退。
这时迁移条件应该来自已有业务状态,例如章节完成标记、任务进度或道具表,而不是简单写死。默认值是“无法从历史事实推导时的兜底”,迁移规则才是旧数据到新语义的正式映射。
类型变化必须显式转换
把整数直接改成字符串、把单值改成枚举语义,都会让旧值的解释发生变化。迁移时应先读取旧格式,校验范围,再写入新变量;无法转换时要有清晰策略,例如回退默认值、标记存档需要修复,或拒绝继续加载。
不要把所有迁移永久堆在一个 if 中。项目持续迭代时,应按版本顺序执行 v1→v2、v2→v3 的小迁移,并在最低支持版本提升后删除已经不再需要的旧字段和代码。这样每次变化都只有一个明确责任,回归测试也更容易定位。
用旧存档做回归测试
兼容性不能只测试“新版本新建存档”。发布前至少准备一份每个受支持版本的真实存档,加载后验证关键变量、当前选项和对应游戏状态。
对于变量重命名,验收标准不是“能加载”,而是迁移后的新变量值与旧剧情语义一致;对于新增变量,验收默认值不会把旧玩家送进错误分支。只要这些检查进入自动化或固定发布清单,内容团队就可以继续迭代 Ink,而不必把变量名永久冻结。