如何在 TypeScript 中逐步使用枚举

TypeScript 中的枚举是一种定义一组命名常量的方法，可用于表示相关值的集合。通过为这些值赋予友好名称，它们使代码更具可读性和可维护性。本指南将逐步指导您在 TypeScript 中使用枚举，介绍枚举的类型、优点和实际示例。

什么是枚举？

enum（"enumeration" 的缩写）是 TypeScript 中一种特殊的数据类型，可用于定义一组命名常量。这些命名常量可以表示数字或字符串值，从而使您的代码更具描述性且更不容易出错。

TypeScript 中的枚举类型

TypeScript 中有三种类型的枚举：

数字枚举
字符串枚举
异构枚举

数字枚举

数字枚举是 TypeScript 中的默认枚举。它们是一组命名值，这些值会自动从 0 开始分配数值，或者从自定义起始值（如果指定）开始分配数值。

基本数字枚举示例

下面是一个数字枚举的简单示例：

enum Direction {
  Up,
  Down,
  Left,
  Right
}

let move: Direction = Direction.Up;
console.log(move); // Output: 0

在此示例中，Direction 枚举有四个成员：Up、Down、Left 和 Right。默认情况下，Up 被分配值 0，Down 被分配值 1，依此类推。您还可以为成员指定自定义数值。

具有自定义值的数字枚举

您可以为枚举成员分配自定义值：

enum Status {
  New = 1,
  InProgress,
  Done = 5,
  Cancelled
}

console.log(Status.New); // Output: 1
console.log(Status.InProgress); // Output: 2
console.log(Status.Done); // Output: 5
console.log(Status.Cancelled); // Output: 6

在此示例中，New 设置为 1，InProgress 自动设置为 2，Done 设置为 5，并且 Cancelled 自动设置为 6。

字符串枚举

字符串枚举是另一种类型的枚举，其中每个成员都用字符串文字初始化，使其更易读且更易于调试。

基本字符串枚举示例

下面是一个字符串枚举的示例：

enum Direction {
  Up = "UP",
  Down = "DOWN",
  Left = "LEFT",
  Right = "RIGHT"
}

let move: Direction = Direction.Left;
console.log(move); // Output: "LEFT"

在此示例中，每个枚举成员都使用字符串值进行初始化。与数字枚举不同，字符串枚举没有自动递增的值。

异构枚举

异构枚举是同时包含字符串和数字成员的枚举。虽然可以定义它们，但通常不建议这样做，因为它会导致代码混乱和错误。

异构枚举示例

以下是异构枚举的一个例子：

enum MixedEnum {
  Yes = "YES",
  No = 0,
  Maybe = 1
}

console.log(MixedEnum.Yes); // Output: "YES"
console.log(MixedEnum.No); // Output: 0

在此示例中，MixedEnum 包含字符串和数字值。请谨慎使用此类枚举，因为它们可能会造成混淆。

枚举用例

枚举在各种场景中都很有用：

表示一组相关常量，如方向（上、下、左、右）。
在状态机中定义状态（新建、进行中、完成、已取消）。
在 switch-case 语句中使用它们可以提高可读性。

Switch-Case 示例中的枚举

在 switch-case 语句中使用枚举可以提高代码的可读性并使其更容易管理状态。

enum Status {
  New,
  InProgress,
  Done,
  Cancelled
}

function getStatusMessage(status: Status): string {
  switch (status) {
    case Status.New:
      return "The task is new.";
    case Status.InProgress:
      return "The task is in progress.";
    case Status.Done:
      return "The task is completed.";
    case Status.Cancelled:
      return "The task is cancelled.";
    default:
      return "Unknown status.";
  }
}

console.log(getStatusMessage(Status.InProgress)); // Output: "The task is in progress."

在此示例中，由于使用了枚举，switch-case 语句的可读性更强，且更不容易出错。

结论

TypeScript 中的枚举提供了一种定义一组命名常量的强大方法，可提高代码的可读性和类型安全性。通过使用数字、字符串甚至异构枚举，您可以更好地管理和组织代码。通过本分步指南，您现在应该可以轻松地在 TypeScript 中使用枚举，从而使您的代码更简洁、更易于维护。

typescript 枚举常量数字字符串异构值命名 switch-case 使用示例指南初学者代码