游戏叙事与剧情 / 系统课时
处理多人编辑时的脚本冲突
处理多人编辑时的脚本冲突
Ink 脚本是文本文件,适合使用 Git 管理,但多人同时改同一段对白、同一个 knot 或同一份公共变量文件时,仍会产生冲突。本课建立一套可重复的定位、合并和验证流程,避免“把冲突标记删掉就算解决”。
学习目标
- 能识别 Ink 文本冲突的常见来源
- 能按“理解双方意图、合并语义、重新编译”的顺序处理冲突
- 能通过拆分和提交习惯降低同一文件上的竞争修改
冲突通常从哪里来
最常见的冲突不是 Git 本身出错,而是两个人修改了同一批文本行。例如作者 A 改了选择文案,作者 B 同时在同一个选择下增加跳转;合并时 Git 无法判断应该保留哪一版。
公共文件更容易成为热点。如果全局变量、公共对白、角色状态和临时剧情都堆在一个文件里,多人修改会集中到同一位置。另一个常见来源是大范围格式化或整段移动文本,它会让本来互不相关的内容也落进同一个差异块。

先看冲突,再决定怎么合并
假设同一段剧情被两个人修改,文件里可能出现下面的 Git 冲突标记。这里是冲突状态示例,不能直接交给 Ink 编译器。
=== gate ===
<<<<<<< HEAD
守卫:今晚城门提前关闭。
+ [出示通行证]
-> inside_city
=======
守卫:没有命令,任何人不得入城。
+ [询问原因]
-> ask_guard
>>>>>>> feature/guard-dialogue解决时不要简单选择“ours”或“theirs”。先确认两边的业务意图:一边新增了通行证分支,另一边新增了询问分支,那么正确结果可能是保留新的守卫对白,并同时保留两个有效选择。
=== gate ===
守卫:没有命令,任何人不得入城。
+ [出示通行证]
-> inside_city
+ [询问原因]
-> ask_guard同时还要确认 inside_city 和 ask_guard 在当前故事中都存在,否则文本虽然没有冲突标记,编译或运行仍可能失败。
用 Git 完成一次可验证的合并
处理冲突时,先让 Git 明确告诉你哪些文件仍未解决。下面命令假设当前仓库已经处于一次有冲突的 merge 中。
git status --short预期输出类似:
UU story/gate.inkUU 表示该文件双方都修改且尚未解决。编辑并保存正确的 Ink 内容后,将文件标记为已解决,再检查暂存区差异。
git add story/gate.ink
git diff --cached --check
git status --short预期结果:
M story/gate.ink这里的 M 表示修改已经进入暂存区;如果 git diff --cached --check 没有输出,表示没有发现常见的空白错误。实际状态还会受仓库中其他文件影响。
降低下一次冲突概率
最有效的措施是减少多人同时触碰同一文本区域。按主线章节、支线任务或角色剧情拆分文件,比把所有内容放进一个 story.ink 更利于并行协作。公共文件只放真正共享的定义,避免把临时剧情塞进去。
提交也应保持聚焦。一次提交尽量只完成一个剧情目的,不要顺手做全文件格式化、重排段落或批量改空白。这样即使发生冲突,差异块也更小,合并者更容易理解每一侧的真实意图。
发生冲突时,目标不是尽快消除 <<<<<<< 和 >>>>>>>,而是恢复一个同时满足双方需求、能够通过 Ink 编译并保持剧情走向正确的版本。把文本合并和剧情验证视为同一个流程,团队协作才不会把“无冲突”误当成“无问题”。