Skip to content
Lv1TypeScript进度 8 / 14

第 8 章:枚举、常量与 as const ​

枚举是 TypeScript 里最"不 TS"的一个特性:它一边当类型用,一边在运行时生成真实对象。现代项目里,多数场景有更好的替代方案。


学习目标 ​

  • 知道 enum 编译后到底生成了什么,为什么它有运行时代价
  • 分清数字枚举、字符串枚举、const enum 的差别与各自的坑
  • 会用 as const 对象 + typeof 造出"枚举的替代品"
  • 判断一个场景该用枚举还是字面量联合
  • 知道前后端常量对齐时该选哪种形态

8.1 enum 的基本写法 ​

typescript
enum Direction {
  Up,
  Down,
  Left,
  Right
}

Direction.Up        // 0
Direction[0]        // 'Up'(反向映射)

不写值时,成员从 0 自动递增。也可以手动赋值:

typescript
enum HttpStatus {
  OK = 200,
  NotFound = 404,
  ServerError = 500
}

字符串枚举必须每个成员都赋值:

typescript
enum Role {
  Admin = 'admin',
  Editor = 'editor',
  Viewer = 'viewer'
}

不要写异构枚举(一半数字一半字符串):

typescript
enum Mixed {
  No = 0,
  Yes = 'YES'   // 不推荐,行为容易让人困惑
}

8.2 枚举编译后是什么 ​

这是理解枚举的关键。看数字枚举的产物:

typescript
enum Direction {
  Up,
  Down
}
javascript
// 编译结果
var Direction;
(function (Direction) {
  Direction[Direction["Up"] = 0] = "Up";
  Direction[Direction["Down"] = 1] = "Down";
})(Direction || (Direction = {}));

它做了两件事:

  1. 生成一个真实的 JS 对象 Direction;
  2. 同时写入正向映射(Direction.Up = 0)和反向映射(Direction[0] = "Up")。

字符串枚举没有反向映射,产物更简单:

javascript
var Role;
(function (Role) {
  Role["Admin"] = "admin";
  Role["Editor"] = "editor";
})(Role || (Role = {}));

由此得到三个结论:

事实影响
枚举会进入运行时增加一点产物体积;不能被 tree-shaking 干净地剔除
数字枚举有反向映射Object.keys(Direction) 会拿到 8 个键(4 个名字 + 4 个数字)
枚举是"值"不是"纯类型"可以作为值传参、遍历、序列化

第 1 章那张"哪些语法会留下运行时痕迹"的表里,enum 就在例外那一行。


8.3 const enum 与它的坑 ​

const enum 试图去掉运行时对象,把使用处直接内联成字面量:

typescript
const enum Flag {
  A = 1,
  B = 2
}

const x = Flag.A
// 编译结果:const x = 1;

看起来很美,但有两个硬伤:

  1. 跨文件内联依赖编译器能读到声明。esbuild、SWC、Babel 这类单文件转译工具做不到,会报 Cannot access ambient const enums when 'isolatedModules' is enabled;
  2. preserveConstEnums 打开后又会生成对象,行为随配置漂移。

现代构建链路(Vite、esbuild、tsx、SWC)基本都是单文件转译,所以 const enum 在实际项目里最好别用。它省下的那点体积,不值得引入一类"只有某些配置下才成立"的语法。

还有一个趋势:Node 的"类型剥离"和 TS 的可擦除语法要求(只允许编译后能被直接删掉的语法),会让 enum、namespace、构造函数参数属性这些"有运行时产物"的写法在新项目里越来越不受欢迎。这不是规范强制,但值得知道方向。


8.4 用 as const 替代枚举 ​

对象形式(最像枚举) ​

typescript
export const ROLES = {
  Admin: 'admin',
  Editor: 'editor',
  Viewer: 'viewer'
} as const

// 从值反推出类型
export type Role = typeof ROLES[keyof typeof ROLES]
// 'admin' | 'editor' | 'viewer'

用法:

typescript
function setRole(role: Role) {}

setRole(ROLES.Admin)     // 推荐:有补全,改名字时一起改
setRole('admin')         // 也可以,字面量直接传
setRole('root')          // 报错

typeof ROLES[keyof typeof ROLES] 这行的读法:

  • typeof ROLES → 拿到对象的类型 { readonly Admin: "admin"; ... };
  • keyof → 键的联合 'Admin' | 'Editor' | 'Viewer';
  • ROLES[...] 索引访问 → 把所有值取出来,得到值的联合。

这三步在第 11 章还会再用,是 TS 里最常用的"从值生成类型"手法。

数组形式(需要遍历时) ​

typescript
export const ROLE_LIST = ['admin', 'editor', 'viewer'] as const
export type Role = typeof ROLE_LIST[number]
// 'admin' | 'editor' | 'viewer'

typeof ROLE_LIST[number] 的意思是"取数组所有元素类型的联合"。需要 ROLE_LIST.map(...)、includes(...) 这类数组操作时用这种。

需要一个"像枚举一样可遍历"的对象 ​

typescript
export const STATUS = {
  Pending: { value: 'pending', label: '待支付' },
  Paid: { value: 'paid', label: '已支付' },
  Refunded: { value: 'refunded', label: '已退款' }
} as const

export type Status = typeof STATUS[keyof typeof STATUS]['value']

// 遍历生成下拉框
const options = Object.values(STATUS).map((s) => ({
  value: s.value,
  label: s.label
}))

这一招把"值、显示文案、可遍历"合在一个对象里,是枚举最实用的替代形态。


8.5 枚举 vs 字面量联合:怎么选 ​

维度字面量联合 + as constenum
运行时代码无(as const 对象本身是你要的数据)有,生成映射对象
反向映射不需要数字枚举自带,容易误用
可遍历用 Object.values / 数组数字枚举会混入数字键
与 JSON 序列化天然是字符串数字枚举序列化成数字,和接口对不上
编辑器补全有(对象属性)有
跨包共享直接导出常量对象导出枚举,消费方也要用 TS
学习成本需要理解 keyof / typeof语法直白
可擦除语法兼容✅❌

结论:默认用 as const + 联合类型。 只有在一种情况下枚举更合适:你需要的是一个"语义上的命名常量集合",且团队已经统一用枚举、不想混两套写法。


8.6 前后端常量对齐 ​

这是枚举最容易出事的地方。

typescript
// ❌ 数字枚举发给后端
enum Status {
  Pending,   // 0
  Paid       // 1
}
// 接口里传的是 1,前端日志里看到的是 1,排查时没人知道是哪个状态
typescript
// ✅ 字符串常量,和接口字段一一对应
const STATUS = {
  Pending: 'pending',
  Paid: 'paid'
} as const

三个原则:

  1. 跨系统传输一律用字符串,可读、可日志、可排查;
  2. 常量值就是接口文档里的值,不要在前端做二次映射;
  3. 类型从常量反推,保证"常量改了,类型跟着改,所有使用处编译报错"。

如果后端用 OpenAPI 或 Protobuf 生成类型,这份常量通常由生成器产出,不要手写两份——两份一定会漂移。


8.7 常见误区 ​

误区一:数字枚举可以放心用 Object.keys 遍历。 → 数字枚举有反向映射,Object.keys 会同时拿到名字和数字字符串,得到 8 项而不是 4 项。要遍历用字符串枚举或 as const。

误区二:const enum 又快又省,应该多用。 → 单文件转译工具下会直接报错,且行为依赖配置。现代项目建议不用。

误区三:枚举值改了没关系,反正有类型检查。 → 数字枚举改顺序会静默改变所有值。字符串常量改值,编译器能抓到使用处,但已经发出去的历史数据不会变,要考虑兼容。

误区四:枚举是纯类型,编译后什么都没有。 → 枚举是少数会生成运行时代码的类型语法,第 1 章的表里专门列过。

误区五:as const 只是"变成常量",没什么特别。 → 它同时做了三件事:属性只读、字符串变字面量、数组变只读元组。真正有价值的是后两个——它们让"从值反推类型"成为可能。


本章小结 ​

要点说明
enum 产物生成真实对象;数字枚举带反向映射
字符串枚举无反向映射,跨系统传输更安全
const enum编译期内联,单文件转译工具不兼容,建议不用
异构枚举数字与字符串混用,禁止
as const 对象typeof OBJ[keyof typeof OBJ] 得到值的联合
as const 数组typeof ARR[number] 得到元素联合,适合遍历
选型默认用 as const + 联合,枚举仅在团队统一时使用
前后端对齐一律字符串值,常量与接口文档一一对应

下一章预告 ​

到这里,"描述数据"的部分基本齐了。下一章换个角度:用 class 把数据和行为绑在一起。如果你写过 Java,会发现 TS 的类很像,但有两个关键处完全不同。

👉 第 9 章:类、修饰符与面向对象

本文阅读--次|全站访问--次|访客--人