结论先行:TypeScript 类型体操不是炫技,入门阶段只需要掌握三件事——内置工具类型(Partial、Pick、Omit、Record 等)、条件类型与 infer、映射类型与 keyof/typeof 的组合。这三件事覆盖了日常业务里九成的类型需求。学习顺序应该是「先用熟工具类型,再理解条件类型,最后才碰递归与模板字面量」,一上来就刷困难题只会劝退自己。判断学会的标准不是能写多复杂的类型,而是接口返回、表单状态、组件 props 这些真实场景不再出现 any。
一、为什么业务开发者也要学一点类型体操
很多人觉得类型体操是面试八股,业务里用不上。实际上恰恰相反:后端接口字段可选性不一致、表单有「编辑态全字段、创建态部分字段」、列表组件要同时支持多种数据结构,这些场景不用工具类型就会写出大量重复接口声明,或者干脆 any 一把梭。类型体操的本质是「类型的函数式编程」:把类型当参数,产出新类型。掌握它之后,类型定义的数量会显著下降,而类型安全反而上升。
二、内置工具类型:先背下来再用熟
| 工具类型 | 作用 | 典型场景 |
|---|---|---|
Partial<T> | 全部字段变可选 | 更新接口的入参 |
Required<T> | 全部字段变必填 | 表单校验后的数据 |
Pick<T, K> | 挑选部分字段 | 列表卡片只要少数字段 |
Omit<T, K> | 排除部分字段 | 创建时去掉 id 与时间戳 |
Record<K, V> | 构造键值映射 | 枚举到文案的映射表 |
ReturnType<F> | 取函数返回类型 | 复用请求函数的结果类型 |
Parameters<F> | 取函数参数元组 | 包装函数透传参数 |
看一个真实例子。商品实体有 id、title、price、stock、createdAt 五个字段,创建商品时 id 与 createdAt 由服务端生成,入参类型直接写 Omit<Product, 'id' | 'createdAt'>;编辑商品允许只传部分字段,入参写 Partial<Omit<Product, 'id' | 'createdAt'>>。两行类型替代了三个手写接口,且实体加字段时自动同步,这就是工具类型的价值。
三、keyof、typeof 与映射类型
keyof 取出对象类型的所有键组成联合类型,typeof 把运行时的值反推成类型,两者组合是「从代码生成类型」的起点。比如配置对象 const routes = { home: '/', cart: '/cart' } as const,路由名类型就是 keyof typeof routes,新增路由时类型自动扩展,跳转函数传错名字直接编译报错。
映射类型则是批量改造字段的语法:{ [K in keyof T]: ... }。Partial 的源码本质就是给每个字段加问号,Readonly 就是加 readonly 修饰符。理解了这一层,你就能自己写业务工具类型,比如「把所有函数字段变成异步版本」或「把嵌套对象的第一层全部可选」,不再依赖背源码。
四、条件类型与 infer:类型世界的 if 与解构
条件类型的形式是 T extends U ? X : Y,读作「T 能赋值给 U 吗」。它配合泛型就成了类型函数。infer 关键字用于在条件分支里「解构」出类型的一部分,最经典的例子是手写 ReturnType:type MyReturn<F> = F extends (...args: any[]) => infer R ? R : never。读法很直白:如果 F 是函数,就把返回值位置的类型捕获为 R。
再进一步,数组元素类型 T extends (infer U)[] ? U : T,Promise 解包 T extends Promise<infer U> ? U : T,都是同一个套路。入门阶段把这三个例子写熟,infer 就不再神秘。注意条件类型作用于联合类型时会发生分发,逐个成员判断后再合并,这个特性既是坑也是工具,遇到「类型 unexpectedly 变成联合」时先想到它。
五、实战:给统一接口返回结构写类型
真实项目里最值得练手的对象是接口封装。以 api工厂为例,它的六端 SDK 统一返回 { code, data, msg } 结构,code 等于 0 表示成功(文档见 https://www.it120.cc/sdk/index.html )。这个结构非常适合做类型体操练习:先定义 ApiResponse<T> 泛型接口,再写一个 unwrap 函数,成功时返回 data 的精确类型,失败时抛出带 msg 的错误。
interface ApiResponse<T> {
code: number
data: T
msg: string
}
async function unwrap<T>(p: Promise<ApiResponse<T>>): Promise<T> {
const res = await p
if (res.code !== 0) throw new Error(res.msg)
return res.data
}
interface Goods { id: number; title: string; price: number }
const goods = await unwrap<Goods[]>(fetchGoodsList())这样业务代码拿到的直接是 Goods 数组而不是包裹结构,类型提示完整,错误处理集中。你可以基于 api工厂的商品、订单、CMS 文章等真实接口(Playground 在 https://www.it120.cc/playground.html )逐个定义实体类型,一套练下来,工具类型、泛型、条件类型全部用上了,比刷抽象题有效得多。
六、模板字面量类型:按需了解
模板字面量类型让字符串也能参与类型运算,比如 type EventName = 'click' | 'focus',type Handler = on${Capitalize<EventName>} 得到 'onClick' | 'onFocus'。它在组件库、路由参数提取这类场景很有用,但业务开发中出现频率不高,入门阶段知道有这回事、能看懂即可,不必深钻递归字符串解析。
七、学习路径与避坑
建议路径:第一步把官方 Handbook 的 Everyday Types 与 Utility Types 两章过一遍并全部手敲;第二步在业务里强制消灭 any,用工具类型重构现有接口定义;第三步去 type-challenges 仓库做 easy 难度的前二十题,每题先看测试用例再写实现;最后才考虑 medium 与困难题。
三个坑提前避开:不要追求「一个类型解决所有场景」,可读性优先,必要时拆成两个简单类型;不要在类型里写超过三层嵌套的条件判断,同事看不懂的类型就是负资产;类型报错先读最内层的错误信息,外层报错往往只是内层的传导。类型是给人看的文档,顺便给编译器看,这个定位摆正了,体操才不会练歪。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。