游戏叙事与剧情 / 系统课时
用测试路径覆盖关键分支
用测试路径覆盖关键分支
互动小说最容易漏掉的并不是“主线能不能走通”,而是条件组合、状态残留和少见出口。这里把剧情转成可执行的测试路径,用一张关键路径表覆盖主线、异常状态和所有重要结局,并留下可重复验证的记录。
学习目标
- 能把剧情分支整理成可执行、可复测的关键路径。
- 能设计条件组合与异常状态用例,避免只测“正常选择”。
- 能确认所有关键结局都有明确入口、出口和状态预期。
先把剧情变成可检查的路径
测试前不要从“把每个链接都点一遍”开始,而要先识别影响结果的节点:入口、状态写入点、条件分支、不可逆选择和结局。只要这些节点被覆盖,大量仅承担叙事过渡的 Passage 就不必逐个排列组合。
建议先定义四类路径:一条最常见主线、一组状态条件路径、一组异常或边界路径,以及每个必须交付的结局路径。测试表中的每条路径都应从可重复的初始状态开始,不能依赖上一轮试玩残留的变量。

建立关键路径测试表
测试用例至少要写清四件事:前置状态、操作路径、预期状态、预期出口。这样失败时才能判断是链接接错、条件判断错误,还是变量在更早的位置就已经写坏。
| 用例 | 前置状态 | 操作路径 | 预期结果 |
|---|---|---|---|
| T01 主线 | 新游戏 | 接受任务 → 调查 → 返回 | 到达正常结局 |
| T02 条件分支 | 已取得钥匙 | 调查 → 打开密室 | 密室入口可见并可进入 |
| T03 缺失条件 | 未取得钥匙 | 调查 → 尝试进入密室 | 不应绕过条件进入密室 |
| T04 异常状态 | 任务已失败 | 返回委托人 | 进入失败处理,不回到进行中状态 |
| T05 结局出口 | 满足隐藏条件 | 完成最终选择 | 到达隐藏结局且不能继续进入普通剧情 |
如果团队希望把用例纳入版本控制,可以把关键字段保存为数据文件。下面的 JSON 不依赖具体 Twine Story Format,只负责描述测试意图。
[
{
"id": "T02",
"preconditions": ["hasKey=true"],
"steps": ["调查房间", "选择打开密室"],
"expected": ["显示密室内容", "进入密室分支"]
},
{
"id": "T03",
"preconditions": ["hasKey=false"],
"steps": ["调查房间", "尝试进入密室"],
"expected": ["密室入口不可用", "仍停留在公开区域"]
}
]保存为 story-test-cases.json 后,可先验证文件本身没有语法错误。
python3 -m json.tool story-test-cases.json > /dev/null && echo "test cases JSON valid"预期输出:
test cases JSON valid这个检查只证明测试数据格式正确,并不代表剧情逻辑已经通过;真正的验收仍要按路径逐条执行并记录实际结果。
覆盖条件组合和异常状态
条件很多时,不要机械地穷举所有变量组合。先找“会改变可见选项、状态写入或结局”的条件,再重点测试边界:条件刚好满足、刚好不满足、变量缺失、变量值来自旧存档,以及互斥状态同时出现。
例如某个入口要求“已拿钥匙且警报未触发”,至少要覆盖满足两个条件、缺钥匙、已触发警报三种情况。如果系统理论上不允许“有钥匙且任务已失败”,也应构造一次这种异常状态,确认故事能安全回退,而不是出现空白页、死链或无法继续的 Passage。
用结果反推遗漏的出口
每条测试完成后记录实际到达的 Passage、关键变量和结局名称。若某个结局只能“碰巧”到达,却无法从条件表解释为什么能到达,说明路径设计仍不可控;若某个非结局 Passage 没有任何可继续的选择,也应视为死路缺陷。
最终至少要确认:所有必交付结局都有可重复路径;关键条件的真、假边界都被验证;异常状态不会绕过剧情约束;重新开始后关键变量回到预期初始值。这样测试覆盖的不是“点过多少页面”,而是作品真正决定剧情结果的那些状态转换。