状态机必须通过统一入口transitionto变更状态，禁用硬赋值，否则会绕过校验、漏日志、并发覆盖、丢失钩子；需用自定义类型+枚举定义状态，map[state]map[event]state实现类型安全转移，并对状态字段单独加锁保障并发安全。
直接用 switch 判断字符串状态字段 + 散落各处的 if order.State == "paid"，不是状态机，是线上事故的定时器。
为什么不能把状态当普通字段改
状态不是“当前值”，而是“合法转移关系”的入口。硬赋值 order.State = "shipped" 会绕过所有校验：跳过幂等检查、漏记日志、并发下覆盖他人变更、无法触发退出钩子（比如“已支付”要关掉超时任务）。
- 真实场景中，一次支付回调重试 + 后台人工操作同时到达，
State字段可能从"paid"→"canceled"→"shipped"，下游发货单发两遍 - 所有变更必须走统一入口，如
order.TransitionTo(newState string) error或fsm.HandleEvent(e Event) - 状态值必须用常量定义：
const StatePaid = "paid"，禁用字符串字面量
如何用 map[State]map[Event]State 实现类型安全转移
用 string 当状态类型，IDE 补不了、拼错 runtime 才报；全用接口方法穷举事件，加个新事件就得改十几个状态 struct。折中方案是：状态用自定义类型 + 枚举值，事件用具名 struct，转移逻辑收口到一张 map。
- 定义状态类型：
type State uint8，配合const StatePending State = iota列出所有状态 - 事件必须是 struct：
type PayEvent struct{ OrderID string; TxID string }，不是string或int - 转移规则存为
map[State]map[reflect.Type]State，运行时注册：registerTransition(StatePending, (*PayEvent)(nil), StatePaid) -
Handle方法接收interface{}，内部用switch e := event.(type)分发，编译器强制你处理每个 case
并发下 TransitionTo 怎么不丢也不卡
订单被支付回调、风控拦截、人工干预三路同时触发 TransitionTo，锁整个 Order 结构体？那查用户信息、读订单金额也得排队——压测时 QPS 直接腰斩。
- 锁粒度必须只包状态本身：单独声明
stateMu sync.RWMutex字段，读状态用Rlock()，写状态用Lock() -
TransitionTo必须是纯内存操作：只更新State字段、记录日志、发事件，不调 DB、不发 HTTP、不sleep - 耗时动作（如调支付网关、发物流单）移出状态机，改为状态变更后异步启动 goroutine，并通过
channel或回调通知状态机“任务完成” - 如果状态需维护临时数据（如重试次数），别塞进状态字段，改用元数据机制：
e.FSM.SetMetadata("retry_count", 2)
真正难的不是定义状态和事件，而是让每条转移路径都经过预设表校验、每回变更都触发对应钩子、每次并发写都只锁住状态字段本身——漏掉任一环，就从状态机退化成状态泥潭。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
