TypeScript中如何避免字符串字面量在类型与运行时重复使用？

问题背景 #

在使用@types/aws-lambda中的EventBridgeEvent接口时，我们通常会这样定义事件类型：

event: EventBridgeEvent<'stringLiteralFoo', Bar>

然后在判断事件类型时又要重复写一次相同的字符串字面量：

if (event['detail-type'] == 'stringLiteralFoo') {
    // 逻辑代码
}

如果直接把字符串字面量存成普通变量，TypeScript会报错，提示无法将值当作类型使用：

'stringLiteralFoo' refers to a value, but is being used as a type here. Did you mean 'typeof stringLiteralFoo'?

以下是最小复现代码：

export interface EventBridgeEvent<TDetailType extends string, TDetail> {
  'detail-type': TDetailType;
  detail: TDetail;
}

const event: EventBridgeEvent<'Foo1' | 'Foo2', Bar> = {
  'detail-type': 'Foo1',
  detail: {}, // Bar类型
}
if (event['detail-type'] == 'Foo1') {
  // 逻辑代码
}

interface Bar {}

解决方案 #

方法1：用as const定义字面量常量 #

通过as const让TypeScript将常量识别为字面量类型（而非普通string类型），这样就能同时在类型定义和值判断中复用：

// 定义常量，as const 确保类型是具体字面量而非宽泛的string
const FOO_DETAIL_TYPE = 'stringLiteralFoo' as const;
// 从常量中提取对应的类型
type FooDetailType = typeof FOO_DETAIL_TYPE;

// 类型定义时使用提取的字面量类型
event: EventBridgeEvent<FooDetailType, Bar>;

// 判断逻辑直接引用常量，无需重复写字符串
if (event['detail-type'] === FOO_DETAIL_TYPE) {
  // 逻辑代码
}

方法2：用枚举（Enum）管理多类型场景 #

如果需要处理多个不同的detail-type，用枚举统一管理会更清晰：

enum DetailType {
  Foo = 'stringLiteralFoo',
  OrderCreated = 'OrderCreated',
  UserRegistered = 'UserRegistered'
}

// 类型定义直接使用枚举成员
event: EventBridgeEvent<DetailType.Foo, Bar>;

// 判断逻辑同样直接引用枚举成员
if (event['detail-type'] === DetailType.Foo) {
  // 逻辑代码
}

方法3：处理联合类型场景 #

如果你的detail-type是多个字面量的联合类型（比如示例中的'Foo1' | 'Foo2'），可以用常量数组加as const生成联合类型：

// 定义所有可能的detail-type常量数组
const ALL_DETAIL_TYPES = ['Foo1', 'Foo2'] as const;
// 从数组中提取联合类型
type DetailType = typeof ALL_DETAIL_TYPES[number];

// 类型定义使用生成的联合类型
const event: EventBridgeEvent<DetailType, Bar> = {
  'detail-type': 'Foo1',
  detail: {},
};

// 判断时直接引用数组中的成员
if (event['detail-type'] === ALL_DETAIL_TYPES[0]) {
  // 逻辑代码
}

核心思路 #

不管用哪种方法，核心都是把重复的字符串字面量固化成可复用的常量/枚举，让TypeScript既能识别其类型，又能在运行时作为值使用，彻底消除重复编写字符串的问题。

内容的提问来源于stack exchange，提问作者Archmede