我的数字人生

TypeScript 泛型:从抄签名到会写约束

2026 年 9 月 26 日 · 约 9 分钟读完

用 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');  // 编译期就报错

这里的三个点值得记:

第一次写出这个签名的时候有点小激动。它带来的实际好处是:拼错属性名会在编辑器里立刻标红,不用等到运行时出现 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 的很多"复杂写法"其实是在替你做一件事:把运行时才会暴露的错误,提前到写代码的时候。

从这个角度看,花时间写对签名是划算的。

← 返回首页