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

变量值正确却走错分支

变量值正确却走错分支

当 Unity 调试面板里看到的变量值“明明正确”,Ink 却进入了另一条分支,问题通常不在分支文本本身,而在变量写入时机、实际类型、变量来源或条件表达式。下面用一套可观测的定位顺序,把“看起来对”变成“运行时证据对”。

学习目标

  • 能确认条件求值前,Ink 实际读取到的变量值和类型。
  • 能区分初始化时机、类型转换、作用域与条件写法造成的偏差。
  • 能用最小复现和日志验证修复是否真正生效。

先确认分支求值时看到的值

最常见的误判,是只在 Unity 一侧看到某个字段为 10,就默认 Ink 条件求值时也读取到了 10。Ink 分支只会依据当时 Story 状态中的变量计算;如果 Unity 在 Continue() 之后才写入,第一次分支已经选完,再修改变量不会让已执行的路径自动回退。

下面的最小示例把变量写入放在第一次推进剧情之前,并同时记录值和 CLR 类型。项目需已安装 Ink Unity Integration,并将编译后的 Ink JSON 绑定到 inkJson。

csharp
using Ink.Runtime;
using UnityEngine;

public sealed class StoryBranchProbe : MonoBehaviour
{
    [SerializeField] private TextAsset inkJson;
    private Story story;

    private void Start()
    {
        story = new Story(inkJson.text);

        // 条件求值前完成初始化,避免首个 Continue 已经越过分支。
        story.variablesState["reputation"] = 10;
        LogVariable("reputation");

        while (story.canContinue)
        {
            Debug.Log(story.Continue().Trim());
        }
    }

    private void LogVariable(string name)
    {
        object value = story.variablesState[name];
        string typeName = value == null ? "null" : value.GetType().Name;
        Debug.Log($"{name}={value} ({typeName})");
    }
}

对应的 Ink 内容可以保持得很小,只验证一个条件:

text
VAR reputation = 0

{ reputation >= 10:
    高声望路线
- else:
    普通路线
}

预期输出:

text
reputation=10 (Int32)
高声望路线

如果日志先出现“普通路线”,随后才看到 Unity 把变量改成 10,根因就是初始化顺序,而不是比较运算本身。

分支错判排查流程

排查初始化时机与数据覆盖

变量值可能在某个时刻正确,但在条件执行前被另一段初始化逻辑覆盖。常见场景是:先从存档或玩家数据写入 Ink,随后又执行“新游戏默认值”逻辑,把同一个全局变量改回默认值。

定位时不要只搜“谁给变量赋过值”,而要确认最后一次写入发生在什么时候。在所有向 story.variablesState 写值的入口临时增加统一日志,并记录剧情推进前后的顺序。对于首屏就依赖的变量,推荐顺序是:创建 Story → 绑定外部函数 → 恢复或写入初始数据 → 调用第一次 Continue()。

如果同一变量既会从存档恢复,又会从角色系统同步,必须明确谁是权威来源。否则“先恢复后覆盖”和“先覆盖后恢复”会得到完全不同的分支结果。

检查类型而不是只看显示值

调试器里显示的 10 与字符串 "10" 看起来很接近,但条件系统关心实际类型。游戏侧若从 PlayerPrefs.GetString、JSON 字段或网络响应取得文本,应在写入 Ink 前先转成明确的数字或布尔值,不要把“之后再处理类型”留给剧情条件。

例如,游戏数据是字符串时,可在边界层先做转换:

csharp
using System.Globalization;

string raw = "10";
if (!int.TryParse(raw, NumberStyles.Integer, CultureInfo.InvariantCulture, out int reputation))
{
    Debug.LogError($"Invalid reputation: {raw}");
    return;
}

story.variablesState["reputation"] = reputation;
Debug.Log($"Normalized reputation={reputation}");

预期输出:

text
Normalized reputation=10

如果转换失败,应在写入 Story 前停止并记录原始数据。这样可以把“条件错了”缩小为“输入数据不合法”,而不是让错误继续传播。

区分全局变量与局部临时状态

通过 story.variablesState["name"] 读写的是 Ink 的全局变量状态。Ink 脚本中的临时变量、参数或局部计算只在相应作用域内存在,不能把它们当成 Unity 可长期同步的全局状态。

因此,遇到“Unity 读到全局值正确,但某个 knot 内条件仍不符合预期”时,要检查条件实际引用的变量名及其作用域。一个稳妥做法是把需要跨 Unity 与 Ink 同步的状态都声明成明确的全局 VAR,局部变量只承载当前段落的中间计算。

把复杂条件拆成可验证事实

复杂条件最容易让人误把“某个变量正确”当成“整个条件正确”。例如 reputation >= 10 && hasPass 中,即使声望正确,只要 hasPass 为假,仍会进入另一分支。

排查时先把组合条件涉及的每个事实分别打印,再回到 Ink 脚本核对比较符号、边界值和布尔组合。尤其注意 > 与 >=、== 与 != 这类边界差异。

修复完成后,用“刚好小于阈值、等于阈值、刚好大于阈值”三组输入跑一次最小剧情。如果三组结果都符合预期,再恢复完整剧情数据。这样可以同时验证初始化、类型、作用域和条件边界,而不是只验证一次“现在好像走对了”。

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

目录与阅读设置

阅读设置

17

记录一个想法

变量值正确却走错分支

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

登录哪都通