解读 TypeScript 罗列Enum

TypeScript 罗列通过定名常量、类型安全和布局化构造，显著提升代码质量。使用时需根据场景选择符合的类型（数字、字符串或常量罗列），并权衡性能与动态访问需求。掌握其特性和使用的场景，能在复杂项目中有效提升代码的可维护性和结实性。接下来我会通过案例，深入解读Enum。
一、罗列的核心作用

•         替代魔法值 用故意义的名称取代硬编码数字或字符串，减少代码歧义。
  
  2. enum StatusCode { Success = 200, NotFound = 404 }
  3. if (response.status === StatusCode.Success) { ... } // 比直接判断200更清晰

  复制代码
•         类型安全 限制变量只能使用罗列成员，编译器会在赋值或比较时查抄类型。
  
  2. enum Direction { Up, Down }
  3. let dir: Direction = Direction.Up; // 正确
  4. dir = 3; // 错误：不能将数字直接赋值给枚举类型

  复制代码
•         构造相干常量 将逻辑关联的常量归类，便于维护和扩展。
  
  2. enum LogLevel { Info, Warn, Error }

  复制代码

二、罗列的类型与语法

1. 数字罗列（默认）

• 成员默认从 0 开始自增，也可手动赋值。
  
• 支持反向映射：通过值获取名称（仅数字罗列）。
  2. enum Direction {
  3.   Up = 1,     // 显式赋值
  4.   Down,       // 自动递增为2
  5.   Left = 4,
  6.   Right,      // 自动递增为5
  7. }
  8. console.log(Direction.Down);    // 输出: 2
  9. console.log(Direction[2]);      // 输出: "Down"（反向映射）

  复制代码

2. 字符串罗列

• 成员必须显式初始化字符串值。
  
• 无反方向映射，适用于需明确语义的场景。
  2. enum LogLevel {
  3.   Info = "INFO",
  4.   Warn = "WARN",
  5.   Error = "ERROR"
  6. }
  7. console.log(LogLevel.Info); // 输出: "INFO"

  复制代码

3. 常量罗列（const enum）

• 编译时被完全内联，无运行时对象。
  
• 提升性能，但无法反射或动态访问。
  2. const enum Size { Small, Medium }
  3. let size = Size.Small; // 编译后：let size = 0;

  复制代码

4. 异构罗列（不保举）

• 混淆数字和字符串成员，易引发混乱。
  2. enum BooleanLikeEnum {
  3.   No = 0,
  4.   Yes = "YES",
  5. }

  复制代码

5. 同名罗列归并 

多个同名的 Enum 布局会主动归并。

2. enum Foo {
3.   A,
4. }
5. enum Foo {
6.   B = 1,
7. }
8. enum Foo {
9.   C = 2,
10. }
11. // 等同于
12. enum Foo {
13.   A,
14.   B = 1，
15.   C = 2
16. }

复制代码

三、罗列的高级特性

1. 计算成员与常量成员

• 常量成员：值在编译时确定（字面量、其他常量成员引用）。
  
• 计算成员：值在运行时计算（需显式初始化后续成员）。
  2. enum FileAccess {
  3.   None,                   // 常量成员 0
  4.   Read = 1 << 1,          // 计算成员 2
  5.   Write = 1 << 2,         // 计算成员 4
  6.   ReadWrite = Read | Write, // 计算成员 6
  7.   // 后续成员必须显式初始化
  8.   Execute = 8
  9. }

  复制代码

2. 罗列作为类型

• 限制变量或参数只能为罗列成员值，这是罗列的一个缺点。
  2. enum UserRole { Admin, Guest }
  3. function setRole(role: UserRole) { ... }
  4. setRole(UserRole.Admin); // 正确
  5. setRole(2); // 错误：类型不符

  复制代码

四、罗列的优缺点对比

长处缺点提升代码可读性编译后天生额外代码（非 const enum）编译时类型查抄字符串罗列不支持反向映射支持反向映射（数字罗列）异构罗列易导致逻辑混乱便于统一管理常量动态访问可能绕过类型查抄（数字罗列）五、使用场景

•         优先使用字符串罗列 提高代码自形貌性，避免数字罗列的隐式歧义。
  
•         性能敏感场景用 const enum 减少天生代码量，但需确保无需动态访问罗列。
  
•         替代方案考量
  
  
  
  • 联合类型：适用于简朴且无需反向映射的场景。       
    2. type LogLevel = 'INFO' | 'WARN' | 'ERROR';

    复制代码
  • 对象常量：需手动冻结对象防止修改，无类型束缚。       
    2. const LogLevel = { Info: 'INFO' } as const;

    复制代码
         
  

 引用一个例子：Enum 布局比较适合的场景是，成员的值不重要，名字更重要，从而增加代码的可读性和可维护性。

2. enum Operator {
3.   ADD,
4.   DIV,
5.   MUL,
6.   SUB
7. }
8. function compute(
9.   op:Operator,
10.   a:number,
11.   b:number
12. ) {
13.   switch (op) {
14.     case Operator.ADD:
15.       return a + b;
16.     case Operator.DIV:
17.       return a / b;
18.     case Operator.MUL:
19.       return a * b;
20.     case Operator.SUB:
21.       return a - b;
22.     default:
23.       throw new Error('wrong operator');
24.   }
25. }
26. compute(Operator.ADD, 1, 3) // 4

复制代码

 上面示例中，Enum 布局Operator的四个成员表示四则运算“加减乘除”。代码根本不需要用到这四个成员的值，只用成员名就够了。
六、示例对比

罗列 vs 联合类型

罗列方案：

2. enum Theme { Dark = 'dark', Light = 'light' }
3. function setTheme(theme: Theme) { ... }
4. setTheme(Theme.Dark);

复制代码

联合类型方案：

2. type Theme = 'dark' | 'light';
3. function setTheme(theme: Theme) { ... }
4. setTheme('dark');

复制代码

对比：

• 罗列集中管理常量，修改时只需调整罗列定义。
  
• 联合类型无需天生额外代码，适合简朴场景。