游戏叙事与剧情 / 系统课时
检查变量导致的分支异常
检查变量导致的分支异常
剧情明明应该走 A,却稳定进入 B,通常不是“条件系统失效”,而是变量实际值、赋值顺序或条件覆盖关系与预期不同。本课用一套可重复的检查顺序,把错误分支还原成可观察、可验证的问题。
学习目标
- 能先确认分支判断时变量的真实值,而不是只凭初始设想排查。
- 能检查赋值时机、条件顺序与边界值造成的异常分支。
- 能建立“固定初值 → 单次操作 → 观察结果”的最小复现方法。
先把分支变成可观察状态
排查分支时,第一件事不是继续改条件,而是把参与判断的变量和值暴露出来。下面是一个放在 Yarn 节点中的片段示例,先人为固定变量,再在判断前打印它们。
<<set $trust to 0>>
<<set $has_key to false>>
Guide: debug trust={$trust}, has_key={$has_key}
<<if $trust >= 2>>
Guide: 进入高信任分支
<<elseif $has_key == true>>
Guide: 进入钥匙分支
<<else>>
Guide: 进入默认分支
<<endif>>预期结果:
Guide: debug trust=0, has_key=False
Guide: 进入默认分支实际布尔值的显示形式可能因运行环境而略有差异,但分支结果应保持一致。若这里已经进入其他分支,说明问题可以在这个最小节点内复现;若最小节点正常,则应继续检查进入该节点前的状态变化。
按时间顺序检查赋值
变量异常最常见的问题不是“值错了”,而是值在错误的时间才被写入。判断条件只会读取执行到该位置时的当前值,之后发生的赋值不会反过来改变已经做出的选择。
例如下面的写法中,钥匙是在判断结束后才获得的,因此这一次仍会进入默认分支。
<<set $has_key to false>>
<<if $has_key == true>>
Guide: 你已经有钥匙。
<<else>>
Guide: 你现在还打不开门。
<<endif>>
<<set $has_key to true>>预期结果:
Guide: 你现在还打不开门。如果设计目标是“拿到钥匙后立即走钥匙分支”,就必须把 set 放在条件判断之前,或者让玩家完成取钥匙行为后再进入这个节点。排查时按执行顺序逐行检查所有可能写入同一变量的位置,比只盯着条件表达式更有效。

检查条件顺序和边界值
if 与后续 elseif 是从上到下匹配的。一旦前面的条件成立,后面的条件就不会成为本次分支的结果。因此“更具体”的条件通常应该放在“更宽泛”的条件之前,否则宽条件可能提前截获状态。
边界值也要单独核对。例如设计要求“信任值达到 2 才开放”,条件应使用 >= 2;误写成 > 2 时,恰好为 2 的情况会落入其他分支。布尔变量则应确认判断的正反方向,不要把“是否拥有钥匙”和“门是否锁住”这类语义相反的变量混用。
建立可重复的最小复现
稳定排查需要固定测试输入。先把参与条件的变量设置成一组明确值,只执行一个节点,记录进入的分支;然后每次只改变一个变量,再重复运行。这样可以直接形成一张输入与结果对照表。
$trust |
$has_key |
应进入分支 |
|---|---|---|
| 0 | false |
默认分支 |
| 0 | true |
钥匙分支 |
| 2 | false |
高信任分支 |
| 2 | true |
高信任分支 |
如果实际结果与表格不一致,优先检查条件表达式;如果最小节点结果一致、正式剧情却不一致,则问题更可能出现在节点之前的赋值时机或状态恢复过程。最终要验证的不是“这次看起来正常”,而是同一组初值和操作序列能稳定得到同一分支。