TS 泛型你还不会？来！我教你

news2025/1/18 17:17:09

前言：最近遇到了一些写作上的烦恼，自己好像陷入了程序员的通病想法，“这个知识点这么简单，大家应该都会吧，我说出来是不是显得我很笨。”

思考了近一个月，又翻了翻自己最开始写作的文章，文笔虽显稚嫩，但初心是真真正正想和大家分享某一个知识点。那时候的写作不为求阅读量，不为凸显自己的水平，只求能把语言尽可能用大白话表达出来，帮助同样是初学者的某位读者。

而现在怎么随着工作时间的增长，反而越来越违背自己写作的初心了呢？于是就诞生了这篇文章的写作契机。

注意：本文面向 TS 泛型初学者，遂只会用通俗的口语来表达。不会引经据典插入官网文档，我要做的就是让你初步理解它解决了什么事情。

一. 场景再现

我们先不要去想泛型这两个字是什么意思，我们先思考下面这个场景。
有这样一个需求，这个函数可以传递一个字符串，并且把参数原封不动返回。你心想，太简单了，一秒钟实现，ok 工资到手。
产品经理这时候又跑来加了个需求，要求也能输入数字类型，ok，没问题，简单的。
没一会，产品经理又说:不行不行，布尔值也得加上。你虽然抱怨了几句，但还是很快的修改完成了修改。
“emm，那个韩同学呀。我想了一下，还得加上 undefined ，和 null ”这样才完整，看着产品小姐姐满脸笑容的样子，你也生气不起来，于是又加上了两行代码。
现在功能倒是实现了，但是你看着这个函数陷入了沉思，倒不是因为产品经理的需求让你烦恼，而是有一丢丢代码洁癖的你开始思考有没有什么方法让这么一大串的东西简单点呢？🤔

二. 理清线索

我们将刚刚的上面这段代码搬到下面来。

function say(txt: string | number | boolean | undefined | null) {
  return txt;
}

先别着急，我们捋一下目前我们已掌握的线索🤔：(1)这个函数会接受一个参数。(2)这个函数有一个返回值。（3）这个函数的返回值的类型和参数的类型是相对应的。
你突然灵光一闪，我怎么给忘了一个神器了呢？any 救我，好家伙，那你和直接写 js 有什么区别呢？
那到底有没有什么更加简单的方法就能达成我们最初的需求呢？你别说，还真有，加下来引入今天的主角泛型。

三. 泛型的用途

不要被这个名字给吓唬到了，刚开始我不敢去理解这个知识点，有百分之90的原因就是因为泛型这个名字就给人一种很高冷的感觉，但其实理解起来十分简单，只不过它的写法有些特殊，仅此而已。接下来我不会提及“泛型”二字，只让你理解它是干什么的。
这是我们上面的代码，TS 老给我划红线提示我没传参数，我也很急啊，因为我真的不知道该写什么类型，我现在也没确定。
这咋办，于是你在想，我能不能先随便写个东西占着地方，等我真正用的时候再告诉你我需要什么类型。
于是你随手写了一堆符号，先占住位置，但是你并没有声明这个 XXXXX 的类型啊，TS 不知道啊，那我肯定不给你通过的。
这咋整，这不让，那不让，那我还写不写代码了？别急嘛，人家 TS 也不是那么无情，慷慨的甩给你两个尖括号<>，也就是键盘上的大于号&小于号。你和 TS 各退一步，TS 允许你在图书馆占座，但是你得告诉它占座的人是谁，占座的那个人你得用<>包起来。
在哪占座？TS 环顾四周，指着这个位置，“那你就在这坐吧。”
怎么占座？人家不告诉你了嘛？用<>包起来。
此时我们再看 TS 的类型提示，返回值，参数类型都变为了占座的这个人。
当我们实际调用的时候，让占座的人走开，把已知的参数放进去即可。

此时我们再观察函数提示，就会发现 TS 自动帮我们替换掉了 XXXXX 占位符。
到这里你其实会发现，我并没有用常规的大写 T 来这里占位，而是用来一个很不规则的 xxxxx 来占位，其实就是想告诉大家，官方文档用 T ，并不代表它只能用 T，不要把自己局限在“别人这样写，我就只能这样写。” 否则当别人问及你的时候，你只能回答：“我也不知道，我看别人都这样写，所以我才这样写。” 这样其实很不好。

tips：官方这里用 T 其实是取字母 type 的首字母来表达类型占位的概念，写 T 更多的是代码规范而不是定死的结论。