游戏引擎 / 系统课时
让联合类型表达状态变化
让联合类型表达状态变化
角色只能待机、移动或攻击,但使用任意字符串后,拼写错误与缺少攻击目标都会混进状态。本节用带判别字段的联合类型连接状态值与对应数据,让处理分支获得正确字段,并让新增状态时遗漏的分支更容易被发现。
学习目标
- 用字面量联合限定状态取值。
- 通过判别字段收窄到当前状态对应的数据。
- 使用穷尽检查暴露遗漏分支。
状态名和数据应一起出现
仅声明 idle、run、attack 的字符串联合,能防止名字拼错,却无法表达攻击必须有 targetId。把不同状态写成不同对象,再以 kind 作为判别字段,就能让数据关系进入类型系统。攻击分支才拥有目标,待机分支不需要伪造空字符串。
这种类型描述“允许哪些快照”,不会自动限制从哪个状态切换到哪个状态。是否允许攻击中移动、死亡后攻击,需要转移函数额外约束。本例只演示从不同快照产生描述,避免把类型约束和完整状态机混为一谈。

在分支里使用专属字段
文件:main.ts,完整纯 TypeScript 程序。
export {};
type State =
| { kind: 'idle' }
| { kind: 'run'; speed: number }
| { kind: 'attack'; targetId: string };
function unreachable(value: never): never {
// 新增联合成员但遗漏分支时,调用处会类型报错。
throw new Error(`unhandled:${JSON.stringify(value)}`);
}
function describe(state: State): string {
switch (state.kind) {
case 'idle': return 'idle';
case 'run': return `run:${state.speed}`;
case 'attack': return `attack:${state.targetId}`;
default: return unreachable(state);
}
}
// 每个快照只携带自身需要的数据。
const states: State[] = [
{ kind: 'idle' },
{ kind: 'run', speed: 3 },
{ kind: 'attack', targetId: 'enemy-1' },
];
for (const state of states) console.log(describe(state));预期输出:
idle
run:3
attack:enemy-1switch 根据 kind 让编译器缩小候选范围,在 attack 分支访问 targetId 才合理。不存在的字段不应使用断言绕过检查。穷尽处理后,default 分支的值类型是 never;后来增加受伤状态而没加处理分支,会在调用 unreachable 的位置出现诊断。
让转移规则留在逻辑入口
实际游戏可以由函数接收当前状态和动作,返回新的 State;输入组件发出动作,表现组件消费结果。不要让每个订阅者自行拼接状态对象,否则同一个动作可能带来不同结果。类型能保障结果结构,统一入口则保障转移规则。
字符串联合简单、可读、便于日志与存档。需要在 Inspector 里提供枚举选项时,应另外处理 Cocos 的编辑器属性类型;普通 TypeScript 联合类型在编译后消失,并不会自动生成编辑器下拉框。
用扩展状态检查遗漏
练习增加一个带剩余秒数的 hurt 状态,先只扩展联合,观察穷尽检查,再补齐描述分支。这个练习把新增需求的影响变成明确编译反馈。若把状态类型改成 string,穷尽关系就丢失,默认分支只能在运行时处理任意拼写。
判别字段必须在每个成员中使用不同字面量,且分支判断要直接围绕它展开。复杂字段结构不一定更安全,只有结构真正反映业务关联时才值得引入。收窄规则见 TypeScript 判别联合。