游戏客户端架构 / 系统课时

为状态转移写单元测试

为状态转移写单元测试

状态机最容易出错的不是“能不能切换”,而是某个输入在特定前置状态下是否得到唯一、可重复的结果。本节把转移整理成输入、前置状态、结果状态三元组,并用参数化测试覆盖正常、无效和终止状态。

学习目标

  • 把状态转移表达为可重复执行的测试用例
  • 用参数化测试覆盖多组前置状态与输入
  • 区分正常转移、保持原状态和终止状态等边界

把转移拆成三段断言

一条转移测试只关心三件事:给定什么状态、送入什么输入、最后应该是什么状态。测试不依赖帧率、动画或场景对象,失败时也能直接定位是哪一条规则被破坏。

前置状态 输入 期望结果
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,测试就应固定这一行为;若后来改成非法输入抛异常,应同步改测试,而不是让断言模糊地接受多个结果。

把关键边界变成回归护栏

至少覆盖三类边界:从每个可达状态出发的主要输入、无效输入的处理策略、终止状态是否还能离开。新增状态时先补测试矩阵,再改实现,可以把“设计变化”变成可见的测试差异,而不是等到运行时才发现某条旧路径被意外改坏。

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

目录与阅读设置

阅读设置

17

记录一个想法

为状态转移写单元测试

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

登录哪都通