TypeScript 如何忽略类型检查

刚接触编程的朋友，多半都听过“类型检查”这个词——就像老师批改作业时，会揪出你写错的公式、标错的单位，帮你避免很多低级错误。但有时候，我们写代码时可能需要“暂时跳过”这些检查，不然会被卡得寸步难行。今天就来聊聊，和JavaScript最搭的TypeScript里，怎么做到忽略类型检查。

为什么要忽略类型检查？

先别觉得“忽略检查”是偷懒，很多场景下这都是合理的。比如你从老项目里迁移一段代码，这段代码没按TypeScript的规矩写，硬要补全所有类型会花好几个小时；或者你用的第三方工具没做类型声明，强行用会报错；还有些临时测试的代码，只想快速验证逻辑，不想被类型约束耽误进度。就像你整理衣柜时，不想把所有衣服按季节分好，只想把一堆衣服先塞进去应急，这时候“跳过整理”就很有必要。

最常用的单行忽略：// @ts-ignore

这是最直接的方式——在你想忽略检查的那一行代码上面，加一行// @ts-ignore就行。举个例子，假设你想调用一个没做类型声明的第三方函数getData()，TypeScript会报错“找不到这个函数的类型”，这时候在它上面加这句注释，就能顺利运行了。

但要注意，这个注释只能忽略下一行的类型检查，多了没用。而且它相当于“闭眼跳过”，不管那行代码有什么类型问题，全都不管，所以用的时候要小心，别明明写错了变量名，却被你当成“合法”的忽略了。

批量忽略某一段代码：// @ts-nocheck

如果有一大段代码都不想被检查，不用逐行加注释，在这段代码的最开头加// @ts-nocheck就行，它会让当前文件里所有代码都跳过类型检查。比如你刚把一段JavaScript代码复制到TypeScript文件里，整个文件还没来得及做类型改造，就可以用这个注释一次性放行。

不过有个小细节：// @ts-nocheck要放在文件的最最开头，不能夹在其他代码中间，也不能和其他注释混在一起，不然TypeScript会不认它。就像你给外卖备注“不要辣”，要写在订单最显眼的位置，不然厨师可能没看到。

更温和的部分忽略：// @ts-expect-error

这个和@ts-ignore有点像，但更“贴心”——它只会在你写了不该有的类型错误时才生效，要是代码本来就没问题，它还会主动提醒你“这里没错误，不需要忽略”。举个例子，如果你故意写了一行明显的类型错误let num: string = 123，加// @ts-expect-error就能让这行不报错；要是你写的let num: number = 123本来就对，加了这个注释，TypeScript反而会弹出警告，告诉你“这里没错误，不用加忽略”，帮你避免误加注释。

全局配置忽略：修改tsconfig.json

如果不想在代码里加注释，还可以直接改TypeScript的配置文件tsconfig.json。找到里面的"noImplicitAny"或者"strict"这类配置，把它们设为false，就能放宽大部分类型检查规则。比如"strict": false会关闭所有严格的类型检查，相当于给整个项目开了“宽松模式”，但这个方法不推荐在正式项目里用，会让你慢慢依赖类型检查，反而容易出错。

总的来说，忽略类型检查是临时的“应急工具”，不是长期的开发方式。就像你出门忘带钥匙，临时找开锁师傅开门可以，但总不能一直不换锁。如果是正式项目，还是建议尽量补全类型，只在万不得已的情况下用忽略方法，才能兼顾开发效率和代码的稳定性。