游戏叙事与剧情 / 系统课时
为关键分支补自动化测试
为关键分支补自动化测试
剧情系统最难防的不是“完全跑不起来”,而是条件组合、跳转目标或一次性动作在改动后悄悄偏离预期。本节用一组可运行测试覆盖分支命中、节点跳转、任务联动与幂等动作,把高风险规则固定成可重复验证的行为。
学习目标
- 为条件分支与节点跳转设计可复现的断言
- 验证任务状态联动和一次性动作不会重复执行
- 识别适合自动化覆盖的高风险剧情规则
先把可测试边界缩小
自动化测试不应依赖真实 UI、动画或网络服务。更稳定的做法是把“当前状态 + 玩家选择 → 下一个节点 + 副作用”抽成纯逻辑接口。这样失败时可以直接定位到规则,而不是先排查渲染层。
测试数据也要尽量小。每个用例只准备触发当前规则所需的变量,例如 reputation、任务状态和已执行动作集合,避免复用一个不断膨胀的全局存档。
用测试固定关键剧情规则
下面用 Python 的 unittest 模拟一个最小剧情运行器。四个测试分别覆盖条件组合、节点跳转、任务联动和一次性奖励。
python
import unittest
class NarrativeRuntime:
def __init__(self):
self.quest_state = {"q_rescue": "INACTIVE"}
self.executed_once = set()
self.gold = 0
def choose_gate(self, reputation, has_key):
if reputation >= 10 and has_key:
return "node_vip_gate"
return "node_normal_gate"
def enter_rescue_branch(self):
self.quest_state["q_rescue"] = "ACTIVE"
return "node_rescue_start"
def grant_first_meet_reward(self):
action_id = "grant_first_meet_reward"
if action_id in self.executed_once:
return False
self.executed_once.add(action_id)
self.gold += 100
return True
class NarrativeRuntimeTest(unittest.TestCase):
def setUp(self):
self.runtime = NarrativeRuntime()
def test_gate_requires_reputation_and_key(self):
self.assertEqual("node_vip_gate", self.runtime.choose_gate(10, True))
self.assertEqual("node_normal_gate", self.runtime.choose_gate(9, True))
self.assertEqual("node_normal_gate", self.runtime.choose_gate(10, False))
def test_rescue_branch_jumps_to_expected_node(self):
self.assertEqual("node_rescue_start", self.runtime.enter_rescue_branch())
def test_rescue_branch_activates_quest(self):
self.runtime.enter_rescue_branch()
self.assertEqual("ACTIVE", self.runtime.quest_state["q_rescue"])
def test_first_meet_reward_runs_only_once(self):
self.assertTrue(self.runtime.grant_first_meet_reward())
self.assertFalse(self.runtime.grant_first_meet_reward())
self.assertEqual(100, self.runtime.gold)
if __name__ == "__main__":
unittest.main(verbosity=2)预期输出
text
test_first_meet_reward_runs_only_once ... ok
test_gate_requires_reputation_and_key ... ok
test_rescue_branch_activates_quest ... ok
test_rescue_branch_jumps_to_expected_node ... ok
----------------------------------------------------------------------
Ran 4 tests in <TIME>s
OK<TIME> 会随机器性能变化。这里真正重要的是四类行为都被断言,而不是测试数量本身。
条件组合要覆盖边界而不是只测成功路径
像 reputation >= 10 and has_key 这样的条件,至少要覆盖“全部满足”“数值刚好不满足”“布尔条件不满足”。如果只测成功路径,后续有人把 >= 改成 >,测试仍可能完全发现不了。
节点跳转也不要只断言“不是空值”,而要断言具体目标节点。剧情回归常见问题就是仍然发生跳转,但跳到了旧节点或错误分支。
副作用测试要检查状态和次数
任务联动属于副作用,测试时既要检查跳转结果,也要检查任务状态是否同步变化。一次性动作还要连续执行两次,确认第二次不会再次发奖励、解锁成就或写入任务进度。
哪些规则最值得优先补测试
优先自动化那些“改错后玩家还能继续操作,但剧情语义已经错了”的规则,例如关键阵营条件、主线跳转、任务启停、奖励发放和只能执行一次的动作。把这些行为写成断言后,剧情配置或运行时代码一旦改变,回归会在提交阶段直接暴露,而不是等到人工通关时才发现。
按自己的节奏,确认真正理解。