TypeScript 怎么用 Record 构建类型安全的字典映射？

Question

仓乃文 · Accepted Answer

用索引签名 { [key: string]: Value } 定义字典时，键可以是任意 string，无法约束为特定键集合。Record 将键约束为指定的联合类型，确保字典只包含预期的键，访问不存在的键会报错。基本用法： ```typescript type Theme = "light" | "dark" | "system"; type ThemeConfig = Record; const themes: ThemeConfig = { light: { bg: "#fff", fg: "#000" }, dark: { bg: "#000", fg: "#fff" }, system: { bg: "auto", fg: "auto" } // 缺少任何一个键都会报错 }; ``` HTTP 方法映射： ```typescript type Method = "GET" | "POST" | "PUT" | "DELETE"; const methodColors: Record = { GET: "green", POST: "blue", PUT: "orange", DELETE: "red" }; ``` 与索引签名对比： ```typescript // 索引签名：键可以是任意 string const dict: { [key: string]: number } = {}; dict.anyKey = 1; // OK，不安全 // Record：键必须是指定联合类型 const record: Record<"a" | "b", number> = { a: 1, b: 2 }; record.c = 3; // 报错 ``` 补充说明： - Record 等价于 { [P in K]: V }，K 必须是 string | number | symbol 的子类型 - Record 要求所有键都存在，配合 Partial> 可以允许缺失 - 适合枚举映射、配置表、国际化文案等场景 - Record 等价于索引签名，但语义更明确