状态机的核心是状态转移表而非类；应使用枚举定义状态、结构体数组描述转移，避免将状态拆分为独立类，统一在AI对象中用current_state驱动switch分支实现行为与转移。
状态机的核心不是类，是状态转移表
游戏AI里用状态机，不是为了写一堆 if-else 堆出逻辑，而是让状态切换可读、可查、可调试。C++ 中最轻量又可控的方式，是用枚举定义状态，用结构体数组描述转移关系——而不是一上来就封装成 StateMachine 类。
常见错误是把每个状态做成独立类（IdleState、ChaseState），结果状态间共享数据要传指针、生命周期难管理、切状态时容易漏掉清理逻辑。更稳的做法是：所有状态逻辑写在同一个 AI 对象里，只靠一个 current_state 枚举驱动行为分支，转移由查表或显式条件控制。
enum class AIState { Idle, Patrol, Chase, Attack, Stunned };- 转移不靠虚函数调用，而靠
switch (current_state)+ 条件判断，比如if (player_in_sight && distance - 避免在状态内直接修改
current_state，统一收口到一个update_state()函数里做校验和赋值，防止非法跳转（比如从Stunned直接跳到Attack）
如何让状态携带局部数据而不污染主类
巡逻需要记住上一个路点索引，攻击需要计时器，惊呆状态要存被击中的帧数——这些不该全堆在 AI 主类里作为成员变量，否则阅读代码时根本分不清哪个变量属于哪个状态。
推荐用 std::variant 存储当前状态的私有数据：
立即学习“C++免费学习笔记（深入）”；
struct PatrolData { int next_waypoint = 0; float patrol_timer = 0.f; };
struct AttackData { float attack_cooldown = 0.f; };
using StateData = std::variant<std::monostate, PatrolData, AttackData>;
然后在 AI 类中持有一个 StateData state_data;。进入新状态时用 std::visit 或 std::holds_alternative 初始化对应类型；更新时只对当前持有的类型做操作。这样既避免了全局变量泛滥，又不用为每个状态单独 new 对象。
- 别用
void*或裸指针模拟“状态上下文”，C++17 起std::variant是标准且零成本的方案 - 如果编译器不支持 C++17，退化为 union + 手动 tag 枚举，但务必加
assert校验访问类型是否匹配 - 不要在
std::variant里放大对象（如std::vector），优先用引用或 ID 回查外部资源
transition() 函数里最容易忽略的三件事
状态切换看着简单，但实际运行中崩溃或逻辑错乱，90% 出在 transition() 实现细节上。
- 必须先执行「退出当前状态」逻辑（比如停止播放动画、取消计时器、释放临时寻路节点），再设置新状态，最后执行「进入新状态」逻辑（比如播放新动画、重置计时器）。顺序反了会导致资源残留或状态撕裂
- 如果新状态需要初始化参数（如
Chase(player_pos)），不要在transition()参数里硬传，改用「延迟初始化」：把参数暂存为 pending 数据，在下一帧update()开头检测到 pending 状态后才真正构造并切换 - 禁止在
transition()中递归调用自身或触发其他状态切换（例如 A→B 的过程中 B 又立刻切回 A），这会造成栈溢出或无限循环。加一个is_transitioning标志位拦截即可
调试状态机时，std::string_view 比日志打印更高效
运行中想快速知道 AI 当前在哪个状态、刚从哪来、为什么切过去？别依赖 std::cout 或断点——帧率一掉就卡死。真正在意性能的项目，会把状态名编译期固化为 std::string_view，配合一个轻量日志钩子。
做法很简单：给每个 AIState 枚举值配一个 constexpr 名字映射表：
constexpr std::string_view to_string(AIState s) {
switch(s) {
case AIState::Idle: return "Idle";
case AIState::Patrol: return "Patrol";
case AIState::Chase: return "Chase";
default: return "Unknown";
}
}
然后在 transition() 末尾加一句：debug_log("state change: {} → {}", to_string(prev), to_string(current));。整个过程无内存分配、无 IO 阻塞，还能被编译器内联优化掉（DEBUG 宏关闭时）。
比字符串拼接快，比宏定义安全，比注释靠谱——状态机这种靠精确流转吃饭的东西，差一帧都可能让 AI 卡在墙角不动。
