游戏客户端架构 / 系统课时
为状态转移写单元测试
为状态转移写单元测试
状态机最容易出错的不是“能不能切换”,而是某个输入在特定前置状态下是否得到唯一、可重复的结果。本节把转移整理成输入、前置状态、结果状态三元组,并用参数化测试覆盖正常、无效和终止状态。
学习目标
- 把状态转移表达为可重复执行的测试用例
- 用参数化测试覆盖多组前置状态与输入
- 区分正常转移、保持原状态和终止状态等边界
把转移拆成三段断言
一条转移测试只关心三件事:给定什么状态、送入什么输入、最后应该是什么状态。测试不依赖帧率、动画或场景对象,失败时也能直接定位是哪一条规则被破坏。
| 前置状态 | 输入 | 期望结果 |
|---|---|---|
Idle |
Move |
Running |
Running |
Stop |
Idle |
Idle |
Stop |
Idle |
Dead |
Move |
Dead |
这种表格适合先确认规则,再映射成参数化测试。若某个输入在当前状态下不合法,应明确决定是“保持原状态”、抛错还是记录诊断信息,不要让实现隐式决定。
写一个可重复执行的参数化测试
下面示例使用 .NET 的 xUnit 测试模板。先创建测试项目,再把默认测试文件替换为示例代码。
bash
dotnet new xunit -n StateMachineTests
cd StateMachineTests预期结果:目录中会生成可由 dotnet test 识别的 xUnit 测试项目;具体依赖版本取决于本机 .NET SDK。
csharp
using Xunit;
public enum PlayerState
{
Idle,
Running,
Dead
}
public enum Input
{
Move,
Stop,
Kill
}
public sealed class PlayerStateMachine
{
public PlayerState State { get; private set; }
public PlayerStateMachine(PlayerState initial)
{
State = initial;
}
public void Handle(Input input)
{
// 规则集中在一个纯状态转移函数中,测试不依赖场景对象。
State = (State, input) switch
{
(PlayerState.Idle, Input.Move) => PlayerState.Running,
(PlayerState.Running, Input.Stop) => PlayerState.Idle,
(_, Input.Kill) => PlayerState.Dead,
(PlayerState.Dead, _) => PlayerState.Dead,
_ => State
};
}
}
public sealed class StateTransitionTests
{
[Theory]
[InlineData(PlayerState.Idle, Input.Move, PlayerState.Running)]
[InlineData(PlayerState.Running, Input.Stop, PlayerState.Idle)]
[InlineData(PlayerState.Idle, Input.Stop, PlayerState.Idle)]
[InlineData(PlayerState.Dead, Input.Move, PlayerState.Dead)]
public void Transition_matches_expected(
PlayerState before,
Input input,
PlayerState expected)
{
var machine = new PlayerStateMachine(before);
machine.Handle(input);
Assert.Equal(expected, machine.State);
}
}代码保存后执行测试:
bash
dotnet test预期输出:只要四条转移规则都满足,核心统计应为以下结果;完整日志格式可能因 SDK 版本不同而变化。
text
Failed: 0
Passed: 4
Total: 4失败时先看规则而不是实现细节
当测试失败时,先核对三元组是否代表真实设计。例如 Idle + Stop 若设计要求保持 Idle,测试就应固定这一行为;若后来改成非法输入抛异常,应同步改测试,而不是让断言模糊地接受多个结果。
把关键边界变成回归护栏
至少覆盖三类边界:从每个可达状态出发的主要输入、无效输入的处理策略、终止状态是否还能离开。新增状态时先补测试矩阵,再改实现,可以把“设计变化”变成可见的测试差异,而不是等到运行时才发现某条旧路径被意外改坏。
按自己的节奏,确认真正理解。