游戏 AI / 系统课时
如何记录一次完整转移链
如何记录一次完整转移链
状态机出错时,单看“当前状态”通常不够。真正有价值的是把一次转移从触发事件、条件判断、源状态到目标状态完整串起来,让你能回答:谁触发了转移、哪些条件通过、为什么最终进入这个状态。
学习目标
- 设计一组能还原转移过程的日志字段
- 用同一个转移编号关联事件、条件判断与状态切换
- 根据日志快速定位误触发、漏判定和重复转移
一条转移链应该记录什么
一次完整转移至少要覆盖四类信息:时间与帧、触发来源、条件判定、状态结果。只记录 Patrol -> Chase 会丢掉最关键的“为什么”。
推荐为每次转移生成一个 transitionId,然后把同一次决策过程中的多条日志都挂到这个编号下。这样即使多个 NPC 同帧发生状态变化,也能按 ID 还原单条链路。
| 字段 | 作用 | 示例 |
|---|---|---|
transitionId |
关联同一次转移链 | T-0042 |
entityId |
区分具体 NPC | enemy-17 |
frame |
对齐游戏帧 | 8124 |
event |
记录触发来源 | TARGET_ENTERED_VIEW |
fromState |
转移前状态 | Patrol |
guard |
记录关键条件及结果 | hasTarget=true |
toState |
最终目标状态 | Chase |
result |
是否真正执行转移 | APPLIED |
不要把全部上下文对象序列化进日志。优先记录会影响当前转移结论的字段,否则日志会非常大,而且真正的异常信号反而难找。

给每次决策一个关联编号
下面用一个可运行的 C# 示例记录一次 Patrol -> Chase 转移。重点不是日志库,而是日志结构:事件到达、条件判断、最终应用转移都使用同一个 transitionId。
using System;
public static class Program
{
private static int nextId = 1;
public static void Main()
{
string entityId = "enemy-17";
string fromState = "Patrol";
bool targetVisible = true;
int frame = 8124;
string transitionId = $"T-{nextId++:D4}";
Log(transitionId, entityId, frame, "EVENT",
"event=TARGET_ENTERED_VIEW");
Log(transitionId, entityId, frame, "GUARD",
$"name=targetVisible value={targetVisible}");
if (targetVisible)
{
string toState = "Chase";
Log(transitionId, entityId, frame, "APPLY",
$"from={fromState} to={toState} result=APPLIED");
fromState = toState;
}
Console.WriteLine($"currentState={fromState}");
}
private static void Log(
string transitionId,
string entityId,
int frame,
string stage,
string message)
{
Console.WriteLine(
$"[{transitionId}] entity={entityId} frame={frame} stage={stage} {message}");
}
}预期输出:
[T-0001] entity=enemy-17 frame=8124 stage=EVENT event=TARGET_ENTERED_VIEW
[T-0001] entity=enemy-17 frame=8124 stage=GUARD name=targetVisible value=True
[T-0001] entity=enemy-17 frame=8124 stage=APPLY from=Patrol to=Chase result=APPLIED
currentState=Chase实际项目里时间戳也可以记录,但排查逐帧逻辑时,frame 往往比毫秒时间更有用。若状态机运行在固定逻辑 Tick 中,则记录 tick,不要混用渲染帧编号。
失败的候选转移也要留下痕迹
只记录“成功切换”会漏掉另一类常见问题:某个候选转移本来应该发生,却被条件挡住了。例如玩家已经进入攻击距离,但 cooldownReady=false,最终仍停在 Chase。
这种情况应该记录候选目标和失败条件,例如:
[T-0043] entity=enemy-17 frame=8130 stage=CANDIDATE from=Chase to=Attack
[T-0043] entity=enemy-17 frame=8130 stage=GUARD name=inAttackRange value=True
[T-0043] entity=enemy-17 frame=8130 stage=GUARD name=cooldownReady value=False
[T-0043] entity=enemy-17 frame=8130 stage=REJECT to=Attack reason=cooldownReady这组日志不是另一个可执行示例,而是推荐的日志形态。它能直接区分“候选转移根本没被评估”和“候选转移被评估但条件失败”。
按转移链排查异常
遇到敌人突然切错状态时,优先按下面顺序看日志:
- 用
entityId和异常发生帧缩小范围。 - 找到对应
transitionId,收集这条链上的全部记录。 - 先确认触发事件是否合理,再检查条件值是否来自预期上下文。
- 如果多个候选都通过,检查优先级解析后的目标状态。
- 如果同一帧出现多个
APPLY,检查状态切换是否允许重入或重复执行。
一条好用的状态转移日志,不是“打印得多”,而是能把事件、条件和结果放进同一个因果链。只要 transitionId、帧号、实体、条件与目标状态都可关联,多数错误转移都能从日志直接还原。