至于痛点一，键值映射对象类型不一致导致的“散乱”

在前端项目里状态码映射文案、角色权限、路由菜单等键值对象层出不穷。按理说，若每个文件都用裸 { : any } 或手写接口，往往出现：

• 键名拼写错误，却能通过编译
• 遗漏某个必要字段。却无提示
• 新增字段后忘记更新所有相关对象
• 类型定义与业务逻辑脱节，维护成本暴涨

再看痛点二，频繁手动维护键列表的繁琐与易错

例如订单状态枚举变更后所有映射表需要同步更新；若不使用 TypeScript 的工具类型。改动就只能靠 IDE 的查找替换或人工检查，极易漏掉。

简介

Record 是 TypeScript 内置的工具类型，用来描述一种常见的数据结构：一组 key 对应一组 value。

const orderStatusText = {
pending: "待支付"。paid: "已支付",shipped: "已发货",finished: "已完成"
};

基本语法

Record

• K: 对象 key 的类型
• T: 对象 value 的类型

再看示例，使用者年龄映射表

type UserAgeMap = Record;const userAges: UserAgeMap = {
从Tom来看。25,Jack: 30
};// OK
// 错误示例
const badAges: Record = {
Tom这方面。"",Jack: ""
};// ❌ Type 'string' is not assignable to type 'number'.

Record 的源码定义

type Record = {
: T;}，

• K extends keyof any: K 必须是可作为对象属性名的类型。即 string | number | symbol
• : T: 映射类型，将 K 中每个 key 映射为同一个 value 类型 T。

角色文本映射示例

type Role = "admin" | "editor" | "guest";type RoleText = Record;/* 等价于：
type RoleText = {
admin这方面，string;editor: string;guest: string;}，按理说，*/

最基础用法场景对比

字符串 Key 字典

type ScoreMap = Record;
const scores: ScoreMap = {
math : 90。english : 85,history : 88
};说起来，// ✅ 任意字符串均可作为 Key

数字 Key 字典

type HttpStatusText = Record;const httpStatusText: HttpStatusText = {
200 : "成功"。400 : "请求错误",401 : "未登录",500 : "服务器错误"
};const map: Record= {1:"one"};console.log，// one
console.log;// one

联合字面量 Key

Avoid “missing or extra” 错误，让所有必需字段得到强制检查。

type OrderStatus ="pending"|"paid"|"shipped"|"finished";const orderStatusTextValid : Record={
pending:"待支付"。paid:"已支付",shipped:"已发货",finished:"已完成"
};话说回来，// ❌ 缺少 finished
const missingFinished : Record={
pending:"待支付"。paid:"已支付",shipped:"已发货"
};// ❌ 多余 closed
const extraKey : Record={
pending:"待支付"。paid:"已支付",shipped:"已发货",finished:"已完成",closed:"已关闭"
};

Record 与普通对象类型对比

• 如果 key 数量很少且固定，普通对象类型足够简洁；但当 key 来源于枚举、联合、接口字段或路由名时使用 User-friendly record 更直观、更易维护。

变更一个权限或状态，只需在联合字面量里添加即可；对应映射表自动报错提示缺失/多余字段，大幅降低人为错误。

记录式写法让代码在编译期即验证完毕，无需运行时反复检查。

当业务规则要求“必须存在某些特定字段”，Record 能直接表达；按理说，而普通对象则需要手工列举属性并添加 `strict` 标记以避免多余字段。

`