JavaScript / TypeScript / 系统课时
定义泛型
定义泛型
泛型用于编写能够处理多种数据类型、又不会丢失类型关系的代码。通过类型参数,函数、接口和类型别名可以在调用时接收具体类型,并让 TypeScript 自动推导返回值、成员和约束条件。
学习目标
- 使用类型参数定义可复用的泛型函数和类型
- 理解泛型如何保留输入与输出之间的类型关系
- 使用
extends为类型参数添加必要约束
泛型解决什么问题
如果一个函数需要支持字符串、数字或其他对象,直接使用 any 虽然灵活,却会关闭类型检查。调用者无法确认返回值属于什么类型,编辑器也不能提供可靠的属性提示。
泛型使用占位类型表达关系。例如,function first<T>(items: T[]): T | undefined 表示:数组元素是什么类型,返回值就是什么类型或 undefined。这里的 T 不是固定类型,而是在调用时确定的类型参数。
在函数中声明类型参数
类型参数写在函数名后的尖括号中。调用泛型函数时可以显式填写类型,也可以让 TypeScript 根据实参自动推导。
下面的示例同时演示泛型函数、泛型类型别名和类型参数约束:
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));预期输出:
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,让属性名参数只能从目标对象的真实键中选择。