第 8 章:枚举、常量与 as const
枚举是 TypeScript 里最"不 TS"的一个特性:它一边当类型用,一边在运行时生成真实对象。现代项目里,多数场景有更好的替代方案。
学习目标
- 知道
enum编译后到底生成了什么,为什么它有运行时代价 - 分清数字枚举、字符串枚举、
const enum的差别与各自的坑 - 会用
as const对象 +typeof造出"枚举的替代品" - 判断一个场景该用枚举还是字面量联合
- 知道前后端常量对齐时该选哪种形态
8.1 enum 的基本写法
enum Direction {
Up,
Down,
Left,
Right
}
Direction.Up // 0
Direction[0] // 'Up'(反向映射)不写值时,成员从 0 自动递增。也可以手动赋值:
enum HttpStatus {
OK = 200,
NotFound = 404,
ServerError = 500
}字符串枚举必须每个成员都赋值:
enum Role {
Admin = 'admin',
Editor = 'editor',
Viewer = 'viewer'
}不要写异构枚举(一半数字一半字符串):
enum Mixed {
No = 0,
Yes = 'YES' // 不推荐,行为容易让人困惑
}8.2 枚举编译后是什么
这是理解枚举的关键。看数字枚举的产物:
enum Direction {
Up,
Down
}// 编译结果
var Direction;
(function (Direction) {
Direction[Direction["Up"] = 0] = "Up";
Direction[Direction["Down"] = 1] = "Down";
})(Direction || (Direction = {}));它做了两件事:
- 生成一个真实的 JS 对象
Direction; - 同时写入正向映射(
Direction.Up = 0)和反向映射(Direction[0] = "Up")。
字符串枚举没有反向映射,产物更简单:
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 试图去掉运行时对象,把使用处直接内联成字面量:
const enum Flag {
A = 1,
B = 2
}
const x = Flag.A
// 编译结果:const x = 1;看起来很美,但有两个硬伤:
- 跨文件内联依赖编译器能读到声明。esbuild、SWC、Babel 这类单文件转译工具做不到,会报
Cannot access ambient const enums when 'isolatedModules' is enabled; preserveConstEnums打开后又会生成对象,行为随配置漂移。
现代构建链路(Vite、esbuild、tsx、SWC)基本都是单文件转译,所以 const enum 在实际项目里最好别用。它省下的那点体积,不值得引入一类"只有某些配置下才成立"的语法。
还有一个趋势:Node 的"类型剥离"和 TS 的可擦除语法要求(只允许编译后能被直接删掉的语法),会让
enum、namespace、构造函数参数属性这些"有运行时产物"的写法在新项目里越来越不受欢迎。这不是规范强制,但值得知道方向。
8.4 用 as const 替代枚举
对象形式(最像枚举)
export const ROLES = {
Admin: 'admin',
Editor: 'editor',
Viewer: 'viewer'
} as const
// 从值反推出类型
export type Role = typeof ROLES[keyof typeof ROLES]
// 'admin' | 'editor' | 'viewer'用法:
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 里最常用的"从值生成类型"手法。
数组形式(需要遍历时)
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(...) 这类数组操作时用这种。
需要一个"像枚举一样可遍历"的对象
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 const | enum |
|---|---|---|
| 运行时代码 | 无(as const 对象本身是你要的数据) | 有,生成映射对象 |
| 反向映射 | 不需要 | 数字枚举自带,容易误用 |
| 可遍历 | 用 Object.values / 数组 | 数字枚举会混入数字键 |
| 与 JSON 序列化 | 天然是字符串 | 数字枚举序列化成数字,和接口对不上 |
| 编辑器补全 | 有(对象属性) | 有 |
| 跨包共享 | 直接导出常量对象 | 导出枚举,消费方也要用 TS |
| 学习成本 | 需要理解 keyof / typeof | 语法直白 |
| 可擦除语法兼容 | ✅ | ❌ |
结论:默认用 as const + 联合类型。 只有在一种情况下枚举更合适:你需要的是一个"语义上的命名常量集合",且团队已经统一用枚举、不想混两套写法。
8.6 前后端常量对齐
这是枚举最容易出事的地方。
// ❌ 数字枚举发给后端
enum Status {
Pending, // 0
Paid // 1
}
// 接口里传的是 1,前端日志里看到的是 1,排查时没人知道是哪个状态// ✅ 字符串常量,和接口字段一一对应
const STATUS = {
Pending: 'pending',
Paid: 'paid'
} as const三个原则:
- 跨系统传输一律用字符串,可读、可日志、可排查;
- 常量值就是接口文档里的值,不要在前端做二次映射;
- 类型从常量反推,保证"常量改了,类型跟着改,所有使用处编译报错"。
如果后端用 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 的类很像,但有两个关键处完全不同。