Vue / 系统课时

泛型与可复用类型

泛型与可复用类型

泛型解决“逻辑相同但数据类型不同”时的重复定义问题。本节用函数、接口和列表结果三个场景建立可复用类型,并重点说明约束、默认类型与类型推断,最后给出在 Vue 3 组件与组合式函数中可直接复用的设计原则。

学习目标

  • 能为函数和接口声明泛型参数,并理解类型参数在调用时如何被推断。
  • 能用 extends、keyof 等约束限制泛型范围,避免“过度泛化”。
  • 能为列表结果和通用状态封装设计稳定、可读的泛型类型。

从重复函数看泛型的价值

如果一个函数只是“原样返回输入”,分别为字符串、数字编写两个版本并没有业务价值。泛型允许把“输入类型与输出类型保持一致”直接写进类型签名。

ts
function identity<T>(value: T): T {
  return value
}

const userName = identity('Ada')
const retryCount = identity(3)

console.log(userName.toUpperCase())
console.log(retryCount + 1)

预期输出:

text
ADA
4

调用 identity('Ada') 时,TypeScript 会把 T 推断为 string;调用 identity(3) 时则推断为 number。这比返回 any 更安全,因为类型信息没有在函数边界处丢失。

用约束限制可接受的类型

泛型默认可以代表任意类型,因此直接访问某个属性会报错。若函数要求参数一定存在 length,就应把这个前提写成约束,而不是用类型断言绕过检查。

ts
function getLength<T extends { length: number }>(value: T): number {
  return value.length
}

console.log(getLength('vue'))
console.log(getLength([1, 2, 3]))

预期输出:

text
3
3

extends 在这里表示“类型参数必须满足某个结构”,不是类继承。字符串和数组都具有数值类型的 length,所以都可以传入;数字不满足该结构,编译阶段就会被拒绝。

另一个常见约束是 keyof。它可以把第二个参数限制为对象真实存在的键,避免拼错字段名。

ts
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'))

预期输出:

text
Ada

为接口和列表结果建模

企业项目里,接口返回通常不仅有数据,还带分页、状态或错误信息。与其为每一种数据重复声明结果类型,不如把变化部分抽成泛型参数。

ts
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)

预期输出:

text
Ada
2

这里的 PageResult<T> 把“分页结构”固定下来,把具体业务实体交给 T。这样 PageResult<User>、PageResult<Order> 可以共享同一套结构,同时保留完整字段提示。

在组合式函数中保留类型关系

Vue 3 项目经常把加载状态封装为组合式函数。泛型应围绕“数据从哪里进入、以什么类型返回”建立关系,而不是把所有内部变量都参数化。

ts
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)
})

预期输出:

text
Ada

runLoader 不需要知道用户对象长什么样,只要求传入函数返回 Promise<T>,并保证自身最终仍返回 Promise<T>。调用方因此可以继续获得准确的字段提示。

避免把泛型写得过度复杂

可复用类型应优先表达真实关系,而不是追求“万能”。只有一个固定类型时,不需要为了形式使用泛型;如果类型参数在输入和输出之间没有产生约束关系,也要警惕它是否只是多余抽象。

常见判断可以归纳为三点:多个位置需要保持同一类型时使用泛型;需要限定能力时添加 extends 或 keyof;业务实体变化但外层结构稳定时,把变化部分抽成类型参数。这样得到的类型通常既可复用,又容易维护。

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

目录与阅读设置

阅读设置

17

记录一个想法

泛型与可复用类型

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

登录哪都通