游戏 AI / 系统课时

给状态切换加运行时日志

给状态切换加运行时日志

状态机一旦增加到三四个状态,仅看角色表现就很难判断“为什么切换”。这一节给每次迁移记录当前状态、目标状态和触发原因,让误切换、重复请求与循环跳转都有可以追踪的诊断证据。

学习目标

  • 为每次状态迁移记录 From、To 与 Reason
  • 区分正常切换、重复状态请求和首次进入
  • 根据连续日志定位状态循环跳转问题

一条切换日志要回答三个问题

最有诊断价值的日志不是简单写一句“进入 Chase”,而是完整描述一次迁移。至少要回答:从什么状态离开、准备进入什么状态、是哪条条件触发。

推荐保持类似下面的稳定格式:FSM Patrol -> Chase | reason=TargetVisible。固定结构比自然语言描述更容易搜索和聚合,也方便以后接入日志采集系统。

基础日志不需要同时打印位置、血量、速度等所有上下文。先建立可靠的状态迁移链,只有某个问题确实需要这些数据时,再增加对应字段,否则大量敌人同时运行时日志很快会失去可读性。

让切换 API 强制携带原因

比起要求开发者在每个调用点额外打印日志,更可靠的方式是直接让 ChangeState 接收 reason。这样所有切换都会经过同一个诊断入口,也不会因为某个调用点漏写日志而出现迁移链断裂。

csharp
using System;

public interface IState
{
    string Name { get; }
    void Enter();
    void Exit();
}

public sealed class StateMachine
{
    public IState? Current { get; private set; }

    public void ChangeState(IState next, string reason)
    {
        if (Current is null)
        {
            Console.WriteLine($"FSM <none> -> {next.Name} | reason={reason}");
            Current = next;
            Current.Enter();
            return;
        }

        // 重复请求不会重新执行生命周期,但开发阶段仍记录诊断信息。
        if (ReferenceEquals(Current, next))
        {
            Console.WriteLine($"FSM skip {Current.Name} -> {next.Name} | reason={reason}");
            return;
        }

        string from = Current.Name;
        Current.Exit();
        Current = next;
        Current.Enter();

        Console.WriteLine($"FSM {from} -> {Current.Name} | reason={reason}");
    }
}

public sealed class NamedState : IState
{
    public string Name { get; }

    public NamedState(string name)
    {
        Name = name;
    }

    public void Enter()
    {
    }

    public void Exit()
    {
    }
}

public static class Program
{
    public static void Main()
    {
        var machine = new StateMachine();
        var patrol = new NamedState("Patrol");
        var chase = new NamedState("Chase");

        machine.ChangeState(patrol, "Spawn");
        machine.ChangeState(chase, "TargetVisible");
        machine.ChangeState(chase, "TargetStillVisible");
        machine.ChangeState(patrol, "TargetLost");
    }
}

预期输出

text
FSM <none> -> Patrol | reason=Spawn
FSM Patrol -> Chase | reason=TargetVisible
FSM skip Chase -> Chase | reason=TargetStillVisible
FSM Chase -> Patrol | reason=TargetLost

这里特意保留了 skip 日志。它能暴露调用方是否在每帧重复请求当前状态。开发阶段这类信号很有价值;正式版如果日志量过大,可以降低它的日志级别或直接关闭,但不应重新执行 Exit 和 Enter。

让原因保持稳定可检索

reason 最好使用短而稳定的标识,例如 TargetVisible、TargetLost、HealthDepleted、AttackRangeReached。不要让不同调用点随意写“发现玩家”“看到目标”“玩家进入视野”这类同义文本,否则后续很难准确检索同一种切换原因。

当判断条件需要动态数值时,可以保持主原因稳定,再增加独立诊断字段。例如因为距离过远退出追击时,主原因仍使用 TargetTooFar,而实际距离可以另外记录为 distance=12.4。这样既方便机器聚合,又能保留现场证据。

从迁移链定位循环跳转

状态机常见故障之一是两条条件彼此冲突。例如 Patrol 因看到目标切到 Chase,而 Chase 又立即因为距离过远切回 Patrol。角色表面可能只是原地抖动,但迁移日志会形成非常明显的重复模式。

下面是可能观察到的诊断日志示例:

text
FSM Patrol -> Chase | reason=TargetVisible
FSM Chase -> Patrol | reason=TargetTooFar
FSM Patrol -> Chase | reason=TargetVisible
FSM Chase -> Patrol | reason=TargetTooFar

这段是诊断日志示例,不是前面程序的预期输出。出现这种模式时,应优先检查两个状态的切换条件是否重叠,再考虑加入迟滞区间、最短停留时间或更明确的条件优先级,而不是先去修改角色移动代码。

控制日志量而不是取消诊断

开发阶段可以记录全部状态迁移,发布版则需要控制数量。尤其是几十甚至上百个敌人同时运行时,如果每帧都输出状态信息,I/O 开销和日志噪声都可能超过日志本身的诊断价值。

更合理的策略是只把真正发生的迁移记录为正式日志,重复状态请求使用较低级别,并保持统一的 FSM 前缀、状态名和 reason 字段。这样出现误切换时,可以先从迁移链确认是哪条条件触发,再回到对应的感知数据或阈值定位根因。

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

目录与阅读设置

阅读设置

17

记录一个想法

给状态切换加运行时日志

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

登录哪都通