游戏叙事与剧情 / 系统课时

处理多人编辑时的脚本冲突

处理多人编辑时的脚本冲突

Ink 脚本是文本文件,适合使用 Git 管理,但多人同时改同一段对白、同一个 knot 或同一份公共变量文件时,仍会产生冲突。本课建立一套可重复的定位、合并和验证流程,避免“把冲突标记删掉就算解决”。

学习目标

  • 能识别 Ink 文本冲突的常见来源
  • 能按“理解双方意图、合并语义、重新编译”的顺序处理冲突
  • 能通过拆分和提交习惯降低同一文件上的竞争修改

冲突通常从哪里来

最常见的冲突不是 Git 本身出错,而是两个人修改了同一批文本行。例如作者 A 改了选择文案,作者 B 同时在同一个选择下增加跳转;合并时 Git 无法判断应该保留哪一版。

公共文件更容易成为热点。如果全局变量、公共对白、角色状态和临时剧情都堆在一个文件里,多人修改会集中到同一位置。另一个常见来源是大范围格式化或整段移动文本,它会让本来互不相关的内容也落进同一个差异块。

Ink 冲突的处理流程

先看冲突,再决定怎么合并

假设同一段剧情被两个人修改,文件里可能出现下面的 Git 冲突标记。这里是冲突状态示例,不能直接交给 Ink 编译器。

text
=== gate ===
<<<<<<< HEAD
守卫:今晚城门提前关闭。
+ [出示通行证]
    -> inside_city
=======
守卫:没有命令,任何人不得入城。
+ [询问原因]
    -> ask_guard
>>>>>>> feature/guard-dialogue

解决时不要简单选择“ours”或“theirs”。先确认两边的业务意图:一边新增了通行证分支,另一边新增了询问分支,那么正确结果可能是保留新的守卫对白,并同时保留两个有效选择。

text
=== gate ===
守卫:没有命令,任何人不得入城。
+ [出示通行证]
    -> inside_city
+ [询问原因]
    -> ask_guard

同时还要确认 inside_city 和 ask_guard 在当前故事中都存在,否则文本虽然没有冲突标记,编译或运行仍可能失败。

用 Git 完成一次可验证的合并

处理冲突时,先让 Git 明确告诉你哪些文件仍未解决。下面命令假设当前仓库已经处于一次有冲突的 merge 中。

bash
git status --short

预期输出类似:

text
UU story/gate.ink

UU 表示该文件双方都修改且尚未解决。编辑并保存正确的 Ink 内容后,将文件标记为已解决,再检查暂存区差异。

bash
git add story/gate.ink
git diff --cached --check
git status --short

预期结果:

text
M  story/gate.ink

这里的 M 表示修改已经进入暂存区;如果 git diff --cached --check 没有输出,表示没有发现常见的空白错误。实际状态还会受仓库中其他文件影响。

降低下一次冲突概率

最有效的措施是减少多人同时触碰同一文本区域。按主线章节、支线任务或角色剧情拆分文件,比把所有内容放进一个 story.ink 更利于并行协作。公共文件只放真正共享的定义,避免把临时剧情塞进去。

提交也应保持聚焦。一次提交尽量只完成一个剧情目的,不要顺手做全文件格式化、重排段落或批量改空白。这样即使发生冲突,差异块也更小,合并者更容易理解每一侧的真实意图。

发生冲突时,目标不是尽快消除 <<<<<<< 和 >>>>>>>,而是恢复一个同时满足双方需求、能够通过 Ink 编译并保持剧情走向正确的版本。把文本合并和剧情验证视为同一个流程,团队协作才不会把“无冲突”误当成“无问题”。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理多人编辑时的脚本冲突

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通