TypeScript中如何声明允许缺省枚举键的枚举-值映射类型？

一、如何声明允许省略部分枚举键的映射类型 #

如果需要创建从枚举键到其他类型的映射，同时允许省略部分键，有两种简洁的实现方式：

方案1：用Partial包裹Record #

Partial会把Record的所有属性转为可选状态，这样就不需要强制包含所有枚举键：

enum Color {
  RED = 'RED',
  BLUE = 'BLUE',
  GREEN = 'GREEN',
}

// 允许省略任意Color枚举的键
const partialRecord: Partial<Record<Color, number>> = {
  [Color.RED]: 1,
  [Color.BLUE]: 2,
  // 省略GREEN不会触发类型错误
};

方案2：直接定义可选索引类型 #

通过显式标记枚举键为可选，达到和上面一致的效果：

// 明确指定每个Color枚举键都是可选的
const partialMap: { [K in Color]?: number } = {
  [Color.RED]: 1,
};

二、Record和Map行为差异的原因 #

Record的特性 #

Record<Color, number>是TypeScript的对象类型，它的约束逻辑是：对象必须包含Color枚举的所有键。因为TypeScript对固定键的对象类型默认要求所有键必填，目的是保证对象结构完全匹配类型定义，所以缺少GREEN会触发类型检查错误。

Map的特性 #

Map<Color, number>是对JavaScript原生Map结构的类型声明，它的语义是：这个Map可以存储键为Color类型、值为number类型的键值对，但不强制要求包含所有Color枚举成员。

Map本身是动态数据结构，支持随时增删键值对，TypeScript对它的类型检查只关注已存在的键值对是否符合K-V类型规则，不会强制覆盖所有可能的键类型，这就是省略GREEN不会报错的核心原因。

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