什么是枚举（Enums）？#

枚举（Enumerations），通常简称 enums，是许多编程语言中的一项特性，它允许开发者定义一组命名的常量值。枚举特别适合用来表示一组固定的、不变的取值集合。相比使用随机的数字或字符串来表示状态，使用枚举可以为这些预定义的选择赋予有意义的名称。这种方式显著提高了代码的可读性和可维护性，让开发者更容易理解和操作这些值。通过使用枚举，开发者可以避免使用未定义的非法值，从而提高代码的可靠性和安全性。此外，枚举通常还支持遍历其所有成员的功能，进一步增强了其实用性。

为什么在 TypeScript 中使用枚举？#

TypeScript 中的枚举提供了多个重要优势和实际应用场景。它允许开发者定义一组命名的常量，从而显著提升代码的可读性。相比使用一些没有意义的“魔法值”，使用有名称的常量让代码意图更加清晰。枚举还能有效降低使用非法值的概率——任何尝试使用枚举定义范围之外的值的操作，都会在编译阶段报错，从而尽早捕获错误。此外，枚举增强了类型安全性，TypeScript 编译器可以提供更好的自动补全和类型检查支持，大幅减少运行时错误和 bug。

数值枚举（Numeric Enums）#

数值枚举允许为每个枚举成员分配一个数字值，这种方式在表示不同状态或类别时提供了很大的灵活性。

枚举值（Enum Values）#

枚举值，也称为命名常量值，是在枚举中预先定义好的值，它们代表一组离散的、可选的取值。

枚举值示例：

• 性别（Gender）：
  • Male（男性）
  • Female（女性）
  • Other（其他）
• 星期（Days of the Week）：
  • Monday（星期一）
  • Tuesday（星期二）
  • Wednesday（星期三）
  • Thursday（星期四）
  • Friday（星期五）
  • Saturday（星期六）
  • Sunday（星期日）
• 颜色（Colors）：
  • Red（红色）
  • Blue（蓝色）
  • Green（绿色）
  • Yellow（黄色）
• 季节（Seasons）：
  • Spring（春季）
  • Summer（夏季）
  • Autumn（秋季）
  • Winter（冬季）

枚举值提供了一种清晰的方式来表示一组固定的选项。它通过限制可选值来减少错误，并提供了一致的引用方式。

反向映射（Reverse Mapping）#

TypeScript 枚举支持反向映射，即可以通过枚举的数值反查到对应的成员名称。这个特性在需要把数值转换为有意义名称的场景中非常有用。

示例：

1
enum Direction {
2
    North,
3
    South,
4
    East,
5
    West,
6
}
7

8
let dir = Direction.North;
9
let nameOfDirection = Direction[dir]; // "North"

使用数值常量#

使用数值常量可以显著提高代码的可读性和可维护性。数值常量是在程序运行期间不会改变的固定值。

有效使用数值常量的步骤：

1. 识别并确定程序中需要的数值常量。
2. 使用有意义的变量名声明这些常量。
3. 为常量赋予合适的初始值。
4. 在整个程序中统一使用这些常量，而不是直接写硬编码的数字。

常见数值常量示例：

• 数学相关：PI (3.14)、E (2.71828)
• 物理相关：SPEED_OF_LIGHT (299792458 m/s)、GRAVITY (9.8 m/s²)
• 颜色相关：BLACK (0x000000)、WHITE (0xFFFFFF)

字符串枚举（String Enums）#

字符串枚举允许开发者定义一组受限的字符串值。每个成员直接赋值为字符串，使得代码更具描述性，也更易读。

声明字符串枚举的示例：

1
enum Colors {
2
    Red = "RED",
3
    Blue = "BLUE",
4
    Green = "GREEN",
5
    Yellow = "YELLOW",
6
}

枚举提供了一种简单而直接的方式来表达程序意图，并创建清晰的离散状态。它使用有意义的名称替代“魔法数字”或随意字符串，大大提升代码质量。枚举成员的值可以是整数、字符、字符串，甚至自定义类型，具有很强的适应性。

异构枚举（Heterogeneous Enums）#

TypeScript 允许枚举同时包含字符串和数值成员（即异构枚举）。但通常不推荐混合使用，因为这容易造成混淆和不一致。

使用字符串字面量（String Literals）#

直接使用字符串字面量可以简化调试（无需查找数字对应的含义）。虽然字符串枚举值更具描述性，但相对数值枚举，它会占用更多内存，也更容易出现拼写错误，因此在性能敏感场景中需谨慎选择。

联合枚举（Union Enums） / 枚举的联合类型#

在 TypeScript 中，通过联合类型（|）可以将多个枚举成员组合起来，形成一个更精确的类型。这种方式可以增强类型安全性，确保变量只接受有效的枚举值。

字符串值的联合类型#

字符串字面量的联合类型可以让变量接受多个特定的字符串值。虽然灵活，但相比真正的枚举，它缺少编译期的严格约束，因此在需要固定取值集合的场景中，通常推荐优先使用枚举而非纯字符串联合类型。

常量枚举（Const Enums）#

常量枚举（const enum）在编译时会被完全内联移除，不会生成任何运行时对象，因此性能更好。它让代码更简洁、自描述，且无需运行时查找。

常量枚举使用示例：

1
const enum Colors {
2
    Red,
3
    Green,
4
    Blue,
5
}
6

7
let color: Colors = Colors.Green;