Vue / 系统课时
泛型与可复用类型
泛型与可复用类型
泛型解决“逻辑相同但数据类型不同”时的重复定义问题。本节用函数、接口和列表结果三个场景建立可复用类型,并重点说明约束、默认类型与类型推断,最后给出在 Vue 3 组件与组合式函数中可直接复用的设计原则。
学习目标
- 能为函数和接口声明泛型参数,并理解类型参数在调用时如何被推断。
- 能用
extends、keyof等约束限制泛型范围,避免“过度泛化”。 - 能为列表结果和通用状态封装设计稳定、可读的泛型类型。
从重复函数看泛型的价值
如果一个函数只是“原样返回输入”,分别为字符串、数字编写两个版本并没有业务价值。泛型允许把“输入类型与输出类型保持一致”直接写进类型签名。
function identity<T>(value: T): T {
return value
}
const userName = identity('Ada')
const retryCount = identity(3)
console.log(userName.toUpperCase())
console.log(retryCount + 1)预期输出:
ADA
4调用 identity('Ada') 时,TypeScript 会把 T 推断为 string;调用 identity(3) 时则推断为 number。这比返回 any 更安全,因为类型信息没有在函数边界处丢失。
用约束限制可接受的类型
泛型默认可以代表任意类型,因此直接访问某个属性会报错。若函数要求参数一定存在 length,就应把这个前提写成约束,而不是用类型断言绕过检查。
function getLength<T extends { length: number }>(value: T): number {
return value.length
}
console.log(getLength('vue'))
console.log(getLength([1, 2, 3]))预期输出:
3
3extends 在这里表示“类型参数必须满足某个结构”,不是类继承。字符串和数组都具有数值类型的 length,所以都可以传入;数字不满足该结构,编译阶段就会被拒绝。
另一个常见约束是 keyof。它可以把第二个参数限制为对象真实存在的键,避免拼错字段名。
function getProperty<T, K extends keyof T>(obj: T, key: K): T[K] {
return obj[key]
}
const profile = { id: 7, name: 'Ada' }
console.log(getProperty(profile, 'name'))预期输出:
Ada为接口和列表结果建模
企业项目里,接口返回通常不仅有数据,还带分页、状态或错误信息。与其为每一种数据重复声明结果类型,不如把变化部分抽成泛型参数。
interface PageResult<T> {
items: T[]
total: number
page: number
pageSize: number
}
interface User {
id: number
name: string
}
const result: PageResult<User> = {
items: [
{ id: 1, name: 'Ada' },
{ id: 2, name: 'Lin' }
],
total: 2,
page: 1,
pageSize: 20
}
console.log(result.items[0].name)
console.log(result.total)预期输出:
Ada
2这里的 PageResult<T> 把“分页结构”固定下来,把具体业务实体交给 T。这样 PageResult<User>、PageResult<Order> 可以共享同一套结构,同时保留完整字段提示。
在组合式函数中保留类型关系
Vue 3 项目经常把加载状态封装为组合式函数。泛型应围绕“数据从哪里进入、以什么类型返回”建立关系,而不是把所有内部变量都参数化。
type Loader<T> = () => Promise<T>
async function runLoader<T>(loader: Loader<T>): Promise<T> {
const data = await loader()
return data
}
async function loadUser() {
return { id: 1, name: 'Ada' }
}
runLoader(loadUser).then(user => {
console.log(user.name)
})预期输出:
AdarunLoader 不需要知道用户对象长什么样,只要求传入函数返回 Promise<T>,并保证自身最终仍返回 Promise<T>。调用方因此可以继续获得准确的字段提示。
避免把泛型写得过度复杂
可复用类型应优先表达真实关系,而不是追求“万能”。只有一个固定类型时,不需要为了形式使用泛型;如果类型参数在输入和输出之间没有产生约束关系,也要警惕它是否只是多余抽象。
常见判断可以归纳为三点:多个位置需要保持同一类型时使用泛型;需要限定能力时添加 extends 或 keyof;业务实体变化但外层结构稳定时,把变化部分抽成类型参数。这样得到的类型通常既可复用,又容易维护。