TypeScript 泛型:从抄签名到会写约束
用 TypeScript 一年多,泛型一直是"看得懂、写不出"。别人写的 <T> 我能读,自己动手就只会 any。后来分了三个阶段才慢慢会写。
第一阶段:把泛型当"参数"
最直观的理解是:泛型就是给类型用的参数。函数接收值,泛型接收类型。
function first(arr: any[]): any {
return arr[0];
}
// 改成泛型
function first<T>(arr: T[]): T {
return arr[0];
}
好处是调用时自动推断:传 number[] 进去,返回就是 number,不用自己写类型标注。
这一阶段的关键是意识到:泛型是为了让"输入类型"和"输出类型"关联起来,不是为了炫技。如果一个函数的返回值跟参数类型没关系,那它多半不需要泛型。
第二阶段:开始写约束
后来写一个取值函数,想访问对象的某个属性:
function get(obj: object, key: string) {
return obj[key]; // 报错:不能索引
}
用 keyof 约束键的取值范围:
function get<T extends object, K extends keyof T>(obj: T, key: K): T[K] {
return obj[key];
}
const user = { name: 'Ada', age: 36 };
get(user, 'name'); // string
get(user, 'age'); // number
get(user, 'email'); // 编译期就报错
这里的三个点值得记:
K extends keyof T:K 只能是 T 的键之一,写错立刻报错T[K]:返回值类型跟着键走,取age就是numberT extends object:限制 T 必须是对象,否则keyof没意义
第一次写出这个签名的时候有点小激动。它带来的实际好处是:拼错属性名会在编辑器里立刻标红,不用等到运行时出现 undefined。
第三阶段:自己实现工具类型
官方提供了一堆工具类型,比如 Partial、Pick、Omit。我以前只会用,直到自己写了一遍才真懂。
// Partial:全部变可选
type MyPartial<T> = {
[K in keyof T]?: T[K];
};
// Pick:挑几个键
type MyPick<T, K extends keyof T> = {
[K2 in K]: T[K2];
};
// Omit:排除几个键
type MyOmit<T, K extends keyof T> = MyPick<T, Exclude<keyof T, K>>;
[K in keyof T] 这种写法叫映射类型,本质是"遍历 T 的所有键"。加 ? 就是变可选,加 readonly 就是变只读。
自己写过一遍之后,再看 Omit 的定义就不会发怵了——它就是"先排除键,再挑剩下的"。
几个实际用上的场景
1. 接口返回的统一包装
interface ApiRes<T> {
code: number;
msg: string;
data: T;
}
async function req<T>(url: string): Promise<ApiRes<T>> {
const res = await fetch(url);
return res.json();
}
// 调用处
const r = await req<{ id: number; title: string }>('/api/post/1');
r.data.title; // 有类型提示
2. 表单字段校验
type Validator<T> = (value: T) => string | null;
const required = <T>(v: T): string | null =>
v === null || v === undefined || v === '' ? '必填' : null;
我自己踩过的坑
别给所有参数都加泛型。我一开始觉得凡是函数都该泛型化,结果签名变成 <T, U, V>,读起来比 any 还累。后来定了个标准:只有"输入输出类型需要关联"时才用。
类型断言别滥用。as unknown as T 能让报错消失,但那是把问题藏起来。有次我这么做,上线后数据是 undefined,排查了两小时。
泛型默认值很有用。function f<T = string>() 这种写法,在不传类型参数时给个合理默认,比强制调用方写一遍友好。
最后
学泛型的过程让我意识到,TypeScript 的很多"复杂写法"其实是在替你做一件事:把运行时才会暴露的错误,提前到写代码的时候。
从这个角度看,花时间写对签名是划算的。
← 返回首页