游戏叙事与剧情 / 系统课时
管理脚本变更与内容协作
管理脚本变更与内容协作
多人同时修改 Yarn 脚本时,真正危险的不是 Git 出现冲突提示,而是冲突被“顺手解决”后节点丢失、跳转指错或行 ID 被改坏。本节建立一套以小变更、可审查差异和合并后验证为核心的协作方式。
学习目标
- 设计适合 Yarn 脚本的分支、提交和审查粒度,降低多人修改冲突。
- 能在代码审查中识别节点、跳转、变量和
#line相关的高风险改动。 - 建立合并后的编译、分支走查与本地化更新检查。
让一次提交只表达一个内容意图
剧情脚本适合和代码一样进入版本控制,但提交粒度要比“今天写了很多对话”更清楚。一次提交最好只完成一个节点改写、一段分支新增或一次命名调整,避免把结构重构、本地化 ID 变化和大量文案润色混在一起。
文件也应按稳定边界拆分,例如按角色、场景或任务组织,而不是所有对话塞进单个巨大 .yarn 文件。拆分的目的不是追求文件数量,而是减少两个人频繁编辑同一片文本的概率。
下面的 Git 命令可用于提交前检查补丁是否包含空白错误;它不会验证 Yarn 语法,因此只能作为版本控制层的第一道检查。
git diff --check预期输出:补丁没有空白错误时命令不输出内容,并返回成功状态。
<无输出>审查时优先看结构变化
对话脚本的审查不能只读台词是否顺畅。结构性修改会直接改变运行路径,因此应先看“图怎么变了”,再看“句子怎么写”。
审查时重点确认:节点 title 是否被重命名、所有跳转目标是否同步更新、条件分支是否仍覆盖预期路径、变量名称和类型是否被误改、用于本地化的 #line 是否被重复或无故替换。纯措辞修改则应尽量避免顺带改这些结构元素。

解决冲突时不要只追求“能合并”
Yarn 文件是纯文本,Git 能指出同一段被多人修改,却不知道哪一条剧情逻辑才正确。出现冲突时,应先理解双方意图,再重建最终节点,不能简单选择“保留当前”或“保留传入”。
尤其要防止三类静默错误:一方新增的选项被删掉;节点标题保留了新名字但跳转仍指向旧名字;同一句话在冲突处理中被复制两次并带着相同 #line。这些问题未必在文本合并阶段暴露,却会在运行或本地化时造成异常。
合并后做两层验证
第一层是项目级验证:让 Yarn Project 重新导入或编译,处理所有语法错误、未解析引用和项目集成报错。第二层是内容级走查:从受影响节点的入口实际运行主要分支,至少覆盖新增选择、条件路径和跳转终点。
如果项目已经进入多语言阶段,源文改动合并后还要更新 strings 或对应字符串表,并检查哪些译文需要重新处理。不要等版本发布前才一次性同步,因为那会把“脚本变更”和“翻译变更”堆成难以审查的大批量差异。
用协作约定降低未来冲突
最有效的规则通常很少:节点和文件有明确负责人;重命名节点前先搜索所有引用;不要手工复用别人的 #line;结构重构与大规模润色分开提交;合并前看 diff,合并后跑受影响路径。
当这些规则成为固定流程后,Git 冲突只是可见的文本冲突,真正难发现的“丢节点、错跳转、错译文映射”才会显著减少。版本管理的目标不是留下更多提交,而是让每一次内容变化都能被理解、审查和验证。