如何为TypeScript对象键正确绑定枚举类型？

核心问题分析 #

你当前使用{[key in ItemTypes]: Item}定义的类型要求必须包含枚举的所有成员作为键，所以空对象会报错。要兼顾严谨的类型校验和允许部分键存在的需求，可以通过TypeScript的工具类型或可选属性来实现，同时保留枚举的导出能力。

解决方案 #

1. 导出枚举 #

先给枚举添加export关键字，方便其他模块导入：

export enum ItemTypes {
  WOOD,
  STONE
}

2. 选择合适的对象类型 #

根据你对键的实际需求，分两种场景处理：

场景A：键为枚举的数值（0、1）

如果希望对象的键是枚举对应的数值（数字枚举默认行为），使用Partial<Record<ItemTypes, Item>>将所有键设为可选：

interface Item {
  owned: number,
  max: number
}

// 允许包含任意枚举数值作为键，无需全部存在
const stockpile: Partial<Record<ItemTypes, Item>> = {};

// 合法赋值
stockpile[ItemTypes.WOOD] = { owned: 5, max: 10 };
// 非法：键不在枚举范围内，触发类型报错
stockpile[2] = { owned: 3, max: 5 };

场景B：键为枚举的字符串名称（"WOOD"、"STONE"）

如果更习惯用枚举的字符串名称作为键，使用keyof typeof ItemTypes限定键的范围，结合Partial实现可选：

interface Item {
  owned: number,
  max: number
}

// 键限定为枚举的字符串名称，无需全部存在
const stockpile: Partial<Record<keyof typeof ItemTypes, Item>> = {};

// 合法赋值
stockpile["WOOD"] = { owned: 5, max: 10 };
// 非法：键不在枚举名称范围内，触发类型报错
stockpile["IRON"] = { owned: 3, max: 5 };

额外说明 #

• Record<K, V>是TypeScript内置工具类型，用于快速定义键类型为K、值类型为V的对象。
• Partial<T>会将T的所有属性转为可选，避免强制包含枚举的所有成员。
• 如果后续需要确保对象包含所有枚举成员，可在初始化完成后将类型断言为Record<ItemTypes, Item>或Record<keyof typeof ItemTypes, Item>。

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