游戏叙事与剧情 / 系统课时
编辑器里怎样阻止坏数据保存
编辑器里怎样阻止坏数据保存
剧情编辑器真正危险的不是“填错一个字段”,而是错误数据成功进入资源库,直到运行时才暴露。本课把必填、类型、引用和范围校验放到保存入口前,建立一套能明确指出错误位置、并且真正阻止落盘的数据门禁。
学习目标
- 区分必填、类型、引用和范围四类编辑期校验
- 实现一个可复用的保存前验证器,并输出可定位的错误信息
- 理解为什么校验失败必须阻断保存,而不能只弹出警告
保存动作应该先经过数据门禁
编辑器里的“保存”不应直接把当前表单序列化到磁盘或数据库。更稳妥的路径是:先把编辑状态整理成结构化对象,再依次执行字段规则、跨对象引用和业务范围检查;只要存在错误,就返回错误列表并终止写入。

四类检查承担的职责不同。必填检查回答字段是否缺失;类型检查确认数据形态是否符合节点定义;引用检查确认目标节点、任务或角色确实存在;范围检查处理持续时间、概率、优先级等虽然类型正确但数值不合法的情况。
用统一验证器收集所有错误
下面的示例使用普通 JavaScript 表示一份剧情资源。验证器不会遇到第一个错误就立即退出,而是尽量收集本次数据中的全部问题,让策划一次修改完成。
function validateStory(story) {
const errors = [];
if (!story || typeof story !== "object") {
return ["story: 必须是对象"];
}
if (!Array.isArray(story.nodes)) {
return ["nodes: 必须是数组"];
}
const nodeIds = new Set();
for (const [index, node] of story.nodes.entries()) {
if (!node.id || typeof node.id !== "string") {
errors.push(`nodes[${index}].id: 必填且必须为字符串`);
continue;
}
if (nodeIds.has(node.id)) {
errors.push(`nodes[${index}].id: 重复节点 ${node.id}`);
}
nodeIds.add(node.id);
}
for (const [index, node] of story.nodes.entries()) {
if (node.type === "dialogue") {
if (!node.speaker || typeof node.speaker !== "string") {
errors.push(`nodes[${index}].speaker: dialogue 节点必须填写说话人`);
}
if (!node.text || typeof node.text !== "string") {
errors.push(`nodes[${index}].text: dialogue 节点必须填写文本`);
}
}
if (node.type === "choice" && !Array.isArray(node.options)) {
errors.push(`nodes[${index}].options: choice 节点必须使用数组`);
}
if (node.next && !nodeIds.has(node.next)) {
errors.push(`nodes[${index}].next: 引用不存在的节点 ${node.next}`);
}
if (node.duration !== undefined &&
(!Number.isFinite(node.duration) || node.duration < 1 || node.duration > 30)) {
errors.push(`nodes[${index}].duration: 应为 1 到 30 之间的数字`);
}
}
if (story.entry && !nodeIds.has(story.entry)) {
errors.push(`entry: 引用不存在的入口节点 ${story.entry}`);
}
return errors;
}
const story = {
entry: "start",
nodes: [
{
id: "start",
type: "dialogue",
speaker: "",
text: "进入港口。",
next: "missing-node",
duration: 0
},
{
id: "choice-1",
type: "choice",
options: "go-left"
}
]
};
const errors = validateStory(story);
if (errors.length > 0) {
console.log("保存被阻止:");
for (const error of errors) console.log(`- ${error}`);
} else {
console.log("校验通过,可以保存");
}保存为 validate-story.js 后执行 node validate-story.js,预期输出如下:
保存被阻止:
- nodes[0].speaker: dialogue 节点必须填写说话人
- nodes[0].next: 引用不存在的节点 missing-node
- nodes[0].duration: 应为 1 到 30 之间的数字
- nodes[1].options: choice 节点必须使用数组这里先建立全部节点 ID 的集合,再检查 next,可以避免“目标节点写在文件后面就误报不存在”的问题。实际项目中角色 ID、任务 ID、道具 ID 也应采用类似的索引方式,而不是依赖编辑器当前打开了哪些对象。
保存入口必须只接受已通过的数据
验证函数负责发现问题,保存入口负责执行策略。两者最好分开:验证器可以被表单即时提示、批量检查和 CI 工具复用;真正写资源的函数则坚持一个规则——错误列表非空就不写入。
片段示例,下面的 persistStory 代表项目已有的存储实现:
async function saveStory(story, persistStory) {
const errors = validateStory(story);
if (errors.length > 0) {
return { saved: false, errors };
}
await persistStory(story);
return { saved: true, errors: [] };
}这段代码依赖前面的 validateStory 和项目提供的 persistStory,因此属于片段示例。生效行为是:验证失败时 persistStory 永远不会被调用;验证通过后才进入真实写入流程。验证时可以给 persistStory 注入一个记录调用次数的测试替身,确认坏数据下调用次数保持为 0。
错误信息要能直接定位到编辑位置
“数据不合法”这样的提示对内容生产几乎没有帮助。错误至少要携带字段路径,例如 nodes[3].next,编辑器才能进一步把它映射到节点和输入控件。大型项目还可以给规则配置稳定的错误码,但不要牺牲给策划看的自然语言说明。
引用校验还要区分“允许暂时为空”和“填写后必须存在”。例如可选的后继节点为空可能完全合法,但一旦填写了 next,保存时就必须确认目标存在。类似地,范围规则应来自真实业务约束,而不是随意给每个数字字段设置上下限。
哪些问题应该阻断保存
会导致运行时无法解析、跳转到不存在内容、数据类型不匹配或违反明确业务约束的问题,应作为错误阻断保存。命名风格、文本长度建议、未填写备注等不影响运行正确性的规则,更适合做警告,否则编辑器会因为过度严格而妨碍正常生产。
最终应形成两层体验:输入过程中尽早提示,保存入口再次执行完整校验。前者帮助策划快速修改,后者保证任何进入资源库的数据都满足最低运行条件,这才是真正可靠的编辑阶段数据门禁。