TypeScript 实用工具类型速查与手写实现
#常用内置工具类型
ts
interface User {
id: number;
name: string;
email?: string;
}
type A = Partial<User>; // 所有属性可选
type B = Required<User>; // 所有属性必填
type C = Readonly<User>; // 所有属性只读
type D = Pick<User, 'id' | 'name'>;
type E = Omit<User, 'email'>;
type F = Record<'admin' | 'guest', User>;#手写实现
理解原理之后,这些类型其实只有一两行。
#映射类型
ts
type MyPartial<T> = { [K in keyof T]?: T[K] };
type MyRequired<T> = { [K in keyof T]-?: T[K] };
type MyReadonly<T> = { readonly [K in keyof T]: T[K] };
type MyPick<T, K extends keyof T> = { [P in K]: T[P] };
type MyRecord<K extends keyof any, V> = { [P in K]: V };#条件类型与 infer
ts
type MyExclude<T, U> = T extends U ? never : T;
type MyOmit<T, K extends keyof any> = MyPick<T, MyExclude<keyof T, K>>;
type MyReturnType<F> = F extends (...args: any[]) => infer R ? R : never;
type MyParameters<F> = F extends (...args: infer P) => any ? P : never;
type MyAwaited<T> = T extends Promise<infer U> ? MyAwaited<U> : T;infer 可以理解为“在模式匹配中声明一个待推断的类型变量”。
#实战:深度 Partial
内置的 Partial 只处理第一层,配置合并时经常需要深度版本:
ts
type DeepPartial<T> = T extends object
? { [K in keyof T]?: DeepPartial<T[K]> }
: T;
interface Config {
server: { host: string; port: number };
log: { level: 'debug' | 'info' };
}
function mergeConfig(base: Config, patch: DeepPartial<Config>): Config {
return { ...base, server: { ...base.server, ...patch.server }, log: { ...base.log, ...patch.log } };
}
mergeConfig(defaults, { server: { port: 8080 } }); // ✅ 只改端口#实战:从常量数组派生联合类型
ts
const ROLES = ['admin', 'editor', 'viewer'] as const;
type Role = (typeof ROLES)[number]; // 'admin' | 'editor' | 'viewer'
function isRole(x: string): x is Role {
return (ROLES as readonly string[]).includes(x);
}这样数据和类型只维护一份,新增角色时类型自动更新。