在前面的文章中，我介绍了 TypeScript 的对象类型、联合类型和类型别名等高级类型。本文将继续深入探讨 TypeScript 类型系统的另外两个重要特性：字面量类型 和 枚举类型。字面量类型允许我们将类型精确限定为某个具体的值，非常适合用于约束变量的取值范围。枚举类型则是 TypeScript 独有的特性（不存在于 JavaScript 中），用于定义一组命名的常量。掌握这两种类型，可以让我们在开发中更好地表达业务逻辑，提高代码的可读性和可维护性。

一、字面量类型

1，基本概念

// "Hello World" 也可以作为一种类型，叫作字面量类型
let message: "Hello World" = "Hello World";

// 错误：Type '"coder"' is not assignable to type '"Hello World"'
// message = "coder";  // 只能赋值 "Hello World"

// 123 也可以作为一种类型
let num: 123 = 123;
// num = 456;  // 错误：不能赋其他值

2，联合字面量类型

// 将多个字面量类型联合在一起，限制 align 的取值范围
type Alignment = 'left' | 'right' | 'center';

let align: Alignment = 'left';    // 正常
align = 'right';   // 正常
align = 'center';  // 正常

// 错误：Type '"bottom"' is not assignable to type 'Alignment'
// align = 'bottom';

3，字面量推理与 as const

type Method = 'GET' | 'POST';

function request(url: string, method: Method) {
  console.log(`请求 ${url}，方法：${method}`);
}

const options = {
  url: "https://www.example.com/api",
  method: "POST"
};

// 错误：Argument of type 'string' is not assignable to parameter of type 'Method'
// request(options.url, options.method);
// 原因：options.method 被推断为 string 类型，而不是 'POST' 字面量类型

type Method = 'GET' | 'POST';

function request(url: string, method: Method) {
  console.log(`请求 ${url}，方法：${method}`);
}

// ========== 方式一：使用类型断言 as ==========
const options1 = {
  url: "https://www.example.com/api",
  method: "POST"
};
request(options1.url, options1.method as Method);  // 正常

// ========== 方式二：为对象指定类型 ==========
type RequestOptions = {
  url: string;
  method: Method;
};

const options2: RequestOptions = {
  url: "https://www.example.com/api",
  method: "POST"  // 这里必须是 GET 或 POST
};
request(options2.url, options2.method);  // 正常

// ========== 方式三：使用 as const 断言（推荐）==========
const options3 = {
  url: "https://www.example.com/api",
  method: "POST"
} as const;  // 将对象的所有属性变为字面量类型

request(options3.url, options3.method);  // 正常

二、枚举类型

1，认识枚举

// 定义 Direction 枚举
enum Direction {
  LEFT,
  RIGHT
}

// 指定 direction 参数为 Direction 枚举类型
function turnDirection(direction: Direction) {
  switch (direction) {
    case Direction.LEFT:
      console.log("改变角色的方向向左");
      break;
    case Direction.RIGHT:
      console.log("改变角色的方向向右");
      break;
    default:
      // 使用 never 确保枚举的每个成员都被处理
      const _check: never = direction;
      break;
  }
}

// 使用枚举：调用函数时传入对应的枚举项
turnDirection(Direction.LEFT);   // 输出：改变角色的方向向左
turnDirection(Direction.RIGHT);  // 输出：改变角色的方向向右

2，数字枚举

enum Direction {
  LEFT,   // 默认值为 0
  RIGHT   // 默认值为 1
}

// 获取枚举成员的值
console.log(Direction.LEFT);   // 输出：0
console.log(Direction.RIGHT);  // 输出：1

enum Direction {
  LEFT = 100,  // 指定值为 100
  RIGHT       // 自动递增，值为 101
}

console.log(Direction.LEFT);   // 输出：100
console.log(Direction.RIGHT);  // 输出：101

enum Direction {
  LEFT,   // 0
  RIGHT   // 1
}

// 正向映射：名称 -> 值
console.log(Direction.LEFT);      // 输出：0
console.log(Direction["LEFT"]);   // 输出：0

// 反向映射：值 -> 名称
console.log(Direction[0]);        // 输出："LEFT"
console.log(Direction[1]);        // 输出："RIGHT"

3，字符串枚举

enum Direction {
  LEFT = "LEFT",
  RIGHT = "RIGHT"
}

console.log(Direction.LEFT);   // 输出："LEFT"
console.log(Direction.RIGHT);  // 输出："RIGHT"

enum Direction {
  LEFT,           // 数字枚举，值为 0
  RIGHT = "RIGHT" // 字符串枚举
}

console.log(Direction.LEFT);   // 输出：0
console.log(Direction.RIGHT);  // 输出："RIGHT"

4，常量枚举（const enum）

// 普通枚举
enum NormalEnum {
  A,
  B
}

// 常量枚举
const enum ConstEnum {
  A,
  B
}

// 使用枚举
let normal = NormalEnum.A;  // 编译后：var normal = NormalEnum.A;
let constVal = ConstEnum.A; // 编译后：var constVal = 0;（直接内联）

// 常量枚举示例
const enum Direction {
  UP,
  DOWN,
  LEFT,
  RIGHT
}

// 使用常量枚举
let directions = [Direction.UP, Direction.DOWN, Direction.LEFT, Direction.RIGHT];

// 编译后的 JavaScript 代码：
// var directions = [0 /* UP */, 1 /* DOWN */, 2 /* LEFT */, 3 /* RIGHT */];

5，枚举的最佳实践

// 订单状态枚举（数字枚举，便于状态机判断）
enum OrderStatus {
  Pending = 0,
  Paid = 1,
  Shipped = 2,
  Completed = 3,
  Cancelled = 4
}

// 支付方式枚举（字符串枚举，语义清晰）
enum PaymentMethod {
  CreditCard = "CREDIT_CARD",
  WeChat = "WECHAT",
  Alipay = "ALIPAY"
}

// 日志级别（常量枚举，高性能）
const enum LogLevel {
  DEBUG = 0,
  INFO = 1,
  WARN = 2,
  ERROR = 3
}

// 使用示例
function processOrder(status: OrderStatus) {
  if (status === OrderStatus.Pending) {
    console.log("订单待支付");
  } else if (status >= OrderStatus.Paid) {
    console.log("订单已处理");
  }
}

processOrder(OrderStatus.Pending);