Skip to content

枚举反向映射的意外行为

快速摘要

你迭代数字枚举时同时得到了键和值 —— TypeScript 为数字枚举创建反向映射。

为什么发生

  • 你对数字枚举使用 Object.keys() 或 for...in,包含反向映射的值到键条目

  • 你期望只有枚举键但由于反向映射同时得到了键和数字值

  • 字符串枚举改为数字枚举,引入反向映射破坏了现有迭代代码

最小示例

✗ 错误代码
enum Status { Active, Inactive, Pending }
console.log(Object.keys(Status)); // ['0', '1', '2', 'Active', 'Inactive', 'Pending']
console.log(Object.values(Status)); // [0, 1, 2, 'Active', 'Inactive', 'Pending']
✓ 修复代码
const Status = { Active: 'Active', Inactive: 'Inactive', Pending: 'Pending' } as const;
console.log(Object.keys(Status)); // ['Active', 'Inactive', 'Pending']
console.log(Object.values(Status)); // ['Active', 'Inactive', 'Pending']

使用 const 对象替代数字枚举消除了反向映射,迭代只产生已定义的键和值。

如何诊断

  • 记录 Object.keys(Enum) 和 Object.values(Enum) 查看额外的反向映射条目

  • 检查枚举是数字(有反向映射)还是字符串(无反向映射)

  • 迭代数字枚举时使用类型守卫或过滤器分离键和值

如何修复

  • 使用字符串枚举而非数字枚举完全避免反向映射

  • 迭代时过滤掉数字键:keys.filter(k => isNaN(Number(k)))

  • 使用 'as const' 的常量对象替代枚举以更好地控制迭代

如何预防

  • 优先使用字符串枚举或常量对象而非数字枚举以避免反向映射意外

  • 永远不要直接迭代枚举 —— 使用已知键或值的类型化数组

相关资源

相关术语

相关课程

← 返回语言