Record：将键映射到值类型
使用 Record 构建类似字典的类型
Record：将键映射到值类型 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 4 节课。
欢迎
Record 会创建一个对象类型，其中包含特定的键 K，并且所有值都统一为类型 V。对于类似字典的结构，它可以代替手动为每个键编写类型。
Record 基本语法
向 Record 传入键类型和值类型。
type Roles = Record<'admin' | 'user' | 'guest', boolean>;
const access: Roles = { admin: true, user: true, guest: false };使用字符串键的 Record
将 `string` 用作键类型，以创建通用字典。
const headers: Record<string, string> = {
'content-type': 'application/json',
'authorization': 'Bearer token'
};使用 Record 创建查找表
Record 非常适合查找表，可将 ID 或代码映射到值。
const statusLabels: Record<number, string> = {
200: 'OK',
404: 'Not Found',
500: 'Server Error'
};Record 的实现方式
Record 是基于键联合类型的映射类型。
type Record<K extends string | number | symbol, V> = { [P in K]: V };Record 与索引签名
Record 等价于 `{ [key: string]: V }`，但可读性更好，也更易于组合。
// Equivalent:
type A = Record<string, number>;
type B = { [key: string]: number };使用联合值的 Record
值类型可以是联合类型，也可以是复杂类型。
type Config = Record<'development' | 'staging' | 'production', { url: string; debug: boolean }>;部分 Record
与 Partial 结合使用，可以允许部分键缺失。
type OptionalConfig = Partial<Record<'debug' | 'verbose' | 'trace', boolean>>;只读 Record
与 Readonly 结合使用，可以防止修改。
const CODES: Readonly<Record<string, number>> = { A: 1, B: 2 };使用 Record 进行分组
使用 Record 按类别键对项目进行分组。
function groupBy<T>(items: T[], key: keyof T): Record<string, T[]> {
return items.reduce((acc, item) => {
const k = String(item[key]);
(acc[k] ??= []).push(item);
return acc;
}, {} as Record<string, T[]>);
}使用枚举键的 Record
枚举值可以用作 Record 的键。
enum Color { Red = 'RED', Green = 'GREEN', Blue = 'BLUE' }
const hexCodes: Record<Color, string> = {
[Color.Red]: '#FF0000',
[Color.Green]: '#00FF00',
[Color.Blue]: '#0000FF',
};快速检查
`Record<'a' | 'b', number>` 会生成什么？
回顾
Record 会创建一个带类型的字典，其中包含特定的键，并且值类型统一。您可以将它用于查找表、配置映射和 groupBy 结果。结合 Partial 和 Readonly 可以获得更多控制。
常见问题解答
「Record：将键映射到值类型」课时是免费的吗？
是的 — 「Record：将键映射到值类型」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 4 节课。
「Record：将键映射到值类型」这节课中我会学到什么？
使用 Record 构建类似字典的类型 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 TypeScript Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。
「Record：将键映射到值类型」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 TypeScript Academy 课中编写并运行代码吗？
能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。