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

检查变量导致的分支异常

检查变量导致的分支异常

剧情明明应该走 A,却稳定进入 B,通常不是“条件系统失效”,而是变量实际值、赋值顺序或条件覆盖关系与预期不同。本课用一套可重复的检查顺序,把错误分支还原成可观察、可验证的问题。

学习目标

  • 能先确认分支判断时变量的真实值,而不是只凭初始设想排查。
  • 能检查赋值时机、条件顺序与边界值造成的异常分支。
  • 能建立“固定初值 → 单次操作 → 观察结果”的最小复现方法。

先把分支变成可观察状态

排查分支时,第一件事不是继续改条件,而是把参与判断的变量和值暴露出来。下面是一个放在 Yarn 节点中的片段示例,先人为固定变量,再在判断前打印它们。

text
<<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>>

预期结果:

text
Guide: debug trust=0, has_key=False
Guide: 进入默认分支

实际布尔值的显示形式可能因运行环境而略有差异,但分支结果应保持一致。若这里已经进入其他分支,说明问题可以在这个最小节点内复现;若最小节点正常,则应继续检查进入该节点前的状态变化。

按时间顺序检查赋值

变量异常最常见的问题不是“值错了”,而是值在错误的时间才被写入。判断条件只会读取执行到该位置时的当前值,之后发生的赋值不会反过来改变已经做出的选择。

例如下面的写法中,钥匙是在判断结束后才获得的,因此这一次仍会进入默认分支。

text
<<set $has_key to false>>

<<if $has_key == true>>
    Guide: 你已经有钥匙。
<<else>>
    Guide: 你现在还打不开门。
<<endif>>

<<set $has_key to true>>

预期结果:

text
Guide: 你现在还打不开门。

如果设计目标是“拿到钥匙后立即走钥匙分支”,就必须把 set 放在条件判断之前,或者让玩家完成取钥匙行为后再进入这个节点。排查时按执行顺序逐行检查所有可能写入同一变量的位置,比只盯着条件表达式更有效。

变量分支异常的排查顺序

检查条件顺序和边界值

if 与后续 elseif 是从上到下匹配的。一旦前面的条件成立,后面的条件就不会成为本次分支的结果。因此“更具体”的条件通常应该放在“更宽泛”的条件之前,否则宽条件可能提前截获状态。

边界值也要单独核对。例如设计要求“信任值达到 2 才开放”,条件应使用 >= 2;误写成 > 2 时,恰好为 2 的情况会落入其他分支。布尔变量则应确认判断的正反方向,不要把“是否拥有钥匙”和“门是否锁住”这类语义相反的变量混用。

建立可重复的最小复现

稳定排查需要固定测试输入。先把参与条件的变量设置成一组明确值,只执行一个节点,记录进入的分支;然后每次只改变一个变量,再重复运行。这样可以直接形成一张输入与结果对照表。

$trust $has_key 应进入分支
0 false 默认分支
0 true 钥匙分支
2 false 高信任分支
2 true 高信任分支

如果实际结果与表格不一致,优先检查条件表达式;如果最小节点结果一致、正式剧情却不一致,则问题更可能出现在节点之前的赋值时机或状态恢复过程。最终要验证的不是“这次看起来正常”,而是同一组初值和操作序列能稳定得到同一分支。

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

目录与阅读设置

记录一个想法

检查变量导致的分支异常

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

登录哪都通