第56章 类型别名与字面量类型

案例56:类型别名与字面量类型——定义联合字面量类型

题目:定义一个订单状态类型,仅允许 "待支付"、"已支付"、"已发货"、"已完成"、"已取消" 五种字面量字符串,并实现一个状态流转校验函数,模拟真实业务中的状态机约束。

设计思路

利用 type 别名定义联合字面量类型,将合法状态限定在固定集合内;再通过函数参数类型检查与条件判断,演示如何在编译期和运行期双重约束数据,提升代码健壮性。

核心代码

// 定义订单状态联合字面量类型
type OrderStatus = '待支付' | '已支付' | '已发货' | '已完成' | '已取消';

// 定义合法的状态流转表
const allowedTransitions: Record<OrderStatus, OrderStatus[]> = {
  '待支付': ['已支付', '已取消'],
  '已支付': ['已发货', '已取消'],
  '已发货': ['已完成'],
  '已完成': [],
  '已取消': []
};

// 校验函数:返回是否允许从 from 转到 to
function canTransition(from: OrderStatus, to: OrderStatus): boolean {
  return allowedTransitions[from].includes(to);
}

// 测试用例
console.log(canTransition('待支付', '已支付')); // true
console.log(canTransition('待支付', '已完成')); // false
console.log(canTransition('已发货', '已完成')); // true

// 编译期错误示例(取消注释会报错):
// const badStatus: OrderStatus = '待收货';

运行结果

控制台依次输出:true、false、true。若将 badStatus 的注释取消,TypeScript 编译器会直接报错,提示类型不匹配。

测试建议:修改 canTransition 的调用参数,尝试所有合法状态组合;也可以尝试使用 as const 断言数组,进一步收紧类型。

注意事项:字面量类型联合不具备运行时保护,非法值(如来自用户输入)仍可能进入系统,务必在数据边界处添加校验逻辑。

成功要点:通过类型别名与联合字面量,将错误从运行时前移到编译期,显著减少非法状态判断分支;配合状态流转表,让规则清晰可维护。