JavaScript / TypeScript / 系统课时

定义泛型

定义泛型

泛型用于编写能够处理多种数据类型、又不会丢失类型关系的代码。通过类型参数,函数、接口和类型别名可以在调用时接收具体类型,并让 TypeScript 自动推导返回值、成员和约束条件。

学习目标

  • 使用类型参数定义可复用的泛型函数和类型
  • 理解泛型如何保留输入与输出之间的类型关系
  • 使用 extends 为类型参数添加必要约束

泛型解决什么问题

如果一个函数需要支持字符串、数字或其他对象,直接使用 any 虽然灵活,却会关闭类型检查。调用者无法确认返回值属于什么类型,编辑器也不能提供可靠的属性提示。

泛型使用占位类型表达关系。例如,function first<T>(items: T[]): T | undefined 表示:数组元素是什么类型,返回值就是什么类型或 undefined。这里的 T 不是固定类型,而是在调用时确定的类型参数。

在函数中声明类型参数

类型参数写在函数名后的尖括号中。调用泛型函数时可以显式填写类型,也可以让 TypeScript 根据实参自动推导。

下面的示例同时演示泛型函数、泛型类型别名和类型参数约束:

ts
function first<T>(items: readonly T[]): T | undefined {
  return items[0];
}

function getId<T extends { id: string }>(value: T): string {
  return value.id;
}

type ApiResponse<T> = {
  success: boolean;
  data: T;
};

const firstNumber = first([10, 20, 30]);
const firstName = first(["Ada", "Lin"]);

const response: ApiResponse<{ id: string; name: string }> = {
  success: true,
  data: { id: "user-001", name: "Ada" }
};

console.log(firstNumber?.toFixed(1));
console.log(firstName?.toUpperCase());
console.log(getId(response.data));

预期输出:

text
10.0
ADA
user-001

调用 first([10, 20, 30]) 时,TypeScript 将 T 推导为 number,因此返回值是 number | undefined。处理字符串数组时,返回值则自动变为 string | undefined。

使用约束限制可接受类型

泛型默认可以代表任意类型,因此不能直接访问某个特定属性。T extends { id: string } 表示传入值至少必须包含字符串类型的 id 属性,除此之外还可以拥有其他字段。

因此,getId({ id: "p-1", price: 99 }) 是合法调用,而传入 { name: "Book" } 会在编译阶段报错。约束既保留了泛型的灵活性,也让函数内部能够安全访问必要成员。

约束中的 extends 表示“满足该结构”,不是类继承。它同样可以配合联合类型、接口或 keyof 使用,为类型参数限定合法范围。

定义泛型类型

类型别名、接口和类都可以声明类型参数。示例中的 ApiResponse<T> 把响应外壳与业务数据分离,同一个结构可以分别承载用户、订单或商品数据。

当某个泛型类型存在最常用的类型时,可以设置默认值,例如 type Result<T = string> = { data: T }。使用 Result 时默认得到字符串数据,使用 Result<number> 时则明确改为数字数据。

类型参数名称通常使用 T、K、V 等短名称;当一个声明包含多个参数或业务含义较强时,使用 TData、TKey、TValue 会更容易阅读。

避免无意义的泛型

泛型的核心价值是表达类型之间的关联。如果类型参数只出现一次,既不约束其他参数,也不影响返回值,通常不需要声明泛型。

例如,只打印值的函数可以直接接收 unknown,没有必要写成 function log<T>(value: T): void。相反,当参数类型决定返回值类型,或多个参数必须保持一致时,泛型才真正提供额外的类型安全。

不要用泛型替代所有联合类型。候选类型固定且数量很少时,string | number 往往更直接;只有调用者需要传入不同具体类型并保留其信息时,才优先使用类型参数。

本课总结

  • 泛型通过类型参数复用代码,并保留输入、输出和成员之间的类型关系
  • TypeScript 通常能根据实参推导类型参数,无需每次手动填写
  • 使用 extends 添加必要约束,避免退回 any 或过度放宽类型

下一课预告

下一课将继续学习泛型约束与 keyof,让属性名参数只能从目标对象的真实键中选择。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定义泛型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通