技术

TypeScript 的类型能走多远

类型是脚手架

刚学 TypeScript 的时候,很容易迷上类型体操:条件类型、模板字面量类型、递归推导,写出来像谜题一样精巧。

后来参与的项目越来越大,我逐渐意识到,类型的价值不在于它有多强大,而在于它能在多大程度上降低理解成本。

一个例子

假设要给一个请求函数标注返回类型。一种写法是从后端类型里层层推导,保证绝对精确;另一种写法是明确声明一个接口。

interface User {
  id: string;
  name: string;
  email: string;
}

async function fetchUser(id: string): Promise<User> {
  const response = await fetch(`/api/users/${id}`);
  return response.json();
}

后一种写法不够「聪明」,但它把契约写在了最显眼的位置。读代码的人不需要在类型定义之间跳转,就能知道这里会拿到什么。

何时停下

我给自己定了几个停下的信号:

  • 为了消除一个 any,引入了五层类型推导。
  • 类型错误信息需要读三遍才能明白。
  • 同事开始绕开类型,直接写 as。

出现任意一条,就说明类型系统已经从工具变成了负担。

边界感

类型能保证结构正确,但保证不了业务正确。User 类型不会告诉你这个用户是否有权限,接口也不会告诉你数据是否过期。

所以真正重要的类型,通常是那些界定了模块边界的类型:函数的入参、组件的 props、API 的响应。至于函数内部的局部变量,让推断去做就好。

写类型和写注释一样,都是在替未来的读者着想。区别在于,注释可以被忽略,类型不会。

评论

还没有评论,欢迎留下第一句。

写下你的想法