当前位置：首页 > news >正文

TypeScript 高级类型工具：Partial, Required, Record 的妙用与陷阱

news 2026/3/26 19:31:40

在 TypeScript 开发中，灵活运用内置工具类型能极大提升类型安全性和代码简洁度。Partial<T>、Required<T> 和 Record<K, T> 是三个高频实用工具，但理解其原理和边界至关重要。

1. `Partial<T>`：制造“可选”版本

作用： 将类型 T 的所有属性变为可选 (?)。
场景： 适用于对象更新、构造参数等只需提供部分属性的情况。
原理： type Partial<T> = { [P in keyof T]?: T[P]; }
陷阱：
- 浅层操作： 只作用于 T 的直接属性。若属性本身是对象，该嵌套对象的属性不会变可选。
- 允许 undefined： 开启 --exactOptionalPropertyTypes 后，Partial 的属性实际是 属性类型 | undefined，严格模式需注意。

interface User {id: number; name: string; address: {city: string }; }
const updateData: Partial<User> = {name: "Bob" }; //  只更新 name
// updateData.address?.city  错误！address 本身是必须的（但可为 undefined）

2. `Required<T>`：制造“必填”版本

作用： 移除类型 T 中所有属性的可选性 (?)，使其全部变为必填。
场景： 确保函数接收完整对象、从 Partial 结果转换回完整对象。
原理： type Required<T> = { [P in keyof T]-?: T[P]; } (注意 -? 语法)
陷阱：
- 同样只作用于直接属性，嵌套对象内的可选性不受影响。

function createUser(userData: Required<User>) {... } 
const fullUser: Required<User> = {id: 1, name: "Alice", address: {city: "NY" } }; //  所有属性必须存在

3. `Record<K, T>`：构建键值映射类型

作用： 构造一个对象类型，其键的类型为 K，值的类型为 T。
场景： 动态键名对象（如字典、配置映射）、强制统一值类型。
原理： type Record<K extends keyof any, T> = { [P in K]: T; }
关键点：
- K 必须是可作对象键的类型（string | number | symbol）。
- 值类型 T 对所有键完全一致。
陷阱：
- 无法为不同键指定不同的值类型（此时需用索引签名或联合类型）。

type PageInfo = {title: string };
type PageRoutes = Record<'home' | 'about' | 'contact', PageInfo>; 
// 等同于 { home: PageInfo; about: PageInfo; contact: PageInfo; }const config: Record<string, boolean> = {featureA: true, featureB: false }; //  动态键名，统一值类型