索引签名与 Record
在索引签名和 Record 工具类型之间做出选择。
索引签名与 Record 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 4 节课。
为映射指定类型的两种方式
TypeScript 提供了两种描述字典的常见方式：类似 { [k: string]: V } 的索引签名，以及内置的工具类型 Record<K, V>。它们在很大程度上重叠，但读起来有所不同。
Record 工具类型
Record<K, V> 会构造一种对象类型，其 keys 是 K，值是 V。当使用 string 作为键时，它等价于字符串索引签名。
type Scores = Record<string, number>
const game: Scores = { alice: 10, bob: 7 }
console.log(game.alice)等价于索引签名
这两种类型描述的是相同的结构。Record<string, number> 和 { [key: string]: number } 对于任意字符串 keys 来说可以互换。
type A = Record<string, number>
type B = { [key: string]: number }
const a: A = { x: 1 }
const b: B = a // assignable both ways
console.log(b.x)带字面量键联合的 Record
Record 的真正强大之处在于使用有限的字面量 keys 联合。它会生成一个对象，其中列出的每个键都是必需的——这是索引签名无法表达的。
type Role = "admin" | "editor" | "viewer"
type Perms = Record<Role, boolean>
const p: Perms = { admin: true, editor: true, viewer: false }
console.log(p.admin)缺少的 keys 会被捕获
由于每个字面量键都是必需的，遗漏任何一个都会产生编译错误。这是索引签名无法提供的强有力保证。
type Role = "admin" | "editor" | "viewer"
// const bad: Record<Role, boolean> = { admin: true, editor: true }
// Error: property viewer is missing索引签名允许任意键
相比之下，索引签名没有固定边界。您可以添加任何地方都未提及过的 keys，而且没有任何键是必需存在的。
type Open = { [key: string]: number }
const o: Open = {} // no keys required
o.anything = 1 // any key allowed
console.log(o.anything)有限的 keys 集合：优先使用 Record
当 keys 是已知的有限集合时，使用字面量联合的 Record 更清晰、更安全。它明确记录了哪些 keys 存在，并强制要求完整性。
type Direction = "north" | "south" | "east" | "west"
type Moves = Record<Direction, number>
const m: Moves = { north: 1, south: 0, east: 2, west: 0 }
console.log(m.east)开放的 keys 集合：两者皆可
当 keys 没有上限并且在运行时发现时，Record<string, V> 和索引签名都可以使用。许多团队选择 Record 以求简洁，另一些团队则选择索引签名以强调其含义。
type Cache1 = Record<string, string>
type Cache2 = { [url: string]: string }
const c: Cache1 = {}
c["/home"] = "<html>"
console.log(c["/home"])Record 只是映射类型
在底层，Record<K, V> 被定义为一种映射类型：{ [P in K]: V }。了解这一点，就能解释为什么字面量联合会产生必需的 keys，而 string 会产生索引签名。
// lib definition (simplified):
// type Record<K extends string | number | symbol, V> = { [P in K]: V }
type Flags = Record<"a" | "b", boolean>
const f: Flags = { a: true, b: false }
console.log(f.a)具名 keys 加上兜底规则
索引签名可以在一个接口中将兜底规则与固定 keys 组合起来——当您两者都需要时非常方便。单独使用 Record，无法同样简洁地将必需的具名 keys 与开放的兜底规则组合起来。
interface Response {
status: number
[header: string]: number | string
}
const r: Response = { status: 200, "x-id": "abc" }
console.log(r.status)实际选择
经验法则：有限且已知的 keys → 使用 Record<Union, V> 检查完整性。没有上限的 keys → 两种形式均可。需要具名 keys 加兜底规则 → 在接口中使用索引签名。
type Status = "ok" | "error"
type Messages = Record<Status, string>
const msg: Messages = { ok: "done", error: "failed" }
console.log(msg.ok)快速检查
测试您对 Record 和索引签名区别的理解。
回顾
Record<string, V> 等同于字符串索引签名，但使用字面量键联合的 Record 会让列出的每个键都成为必需项，并在编译时捕获遗漏。对于有限且已知的 keys，请使用 Record<Union, V>；对于没有上限的 keys，两种形式均可；当您需要具名 keys 加兜底规则时，请使用索引签名。在底层，Record 是映射类型 { [P in K]: V }。
用 AI 导师学习 TypeScript — 免费
在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。
- 课程
- 101
- 课程
- 352
常见问题解答
「索引签名与 Record」课时是免费的吗？
是的 — 「索引签名与 Record」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 4 节课。
「索引签名与 Record」这节课中我会学到什么？
在索引签名和 Record 工具类型之间做出选择。 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 TypeScript Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「索引签名与 Record」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 TypeScript Academy 课中编写并运行代码吗？
能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 定义索引签名
- 字符串与数字索引签名
- 组合已知键与动态键
- 索引签名与 Record