TypeScript 中避免使用 @ts-ignore 的最佳方案

引言

在 TypeScript 开发中，我们常会遇到需要临时规避类型错误的场景：可能是原型开发阶段追求效率，可能是第三方库类型定义不完整，也可能是暂时想不到优雅的类型解决方案。这时，// @ts-ignore 似乎成了 “快速救星”—— 但实际上，它几乎永远是最糟糕的选择。本文将详细对比 @ts-ignore 与其他替代方案，帮你找到更安全、更易维护的类型错误处理方式。

一、为什么 @ts-ignore 不推荐？

@ts-ignore 的核心问题在于 “过度暴力”：它会无条件屏蔽下一行代码的所有类型错误，哪怕后续代码修复了原问题，这个注释依然会生效，甚至可能掩盖新的 Bug。

举个例子，下面的代码明显存在类型不匹配（数字赋值给字符串），但 @ts-ignore 会让 TypeScript 完全 “视而不见”：

// @ts-ignore

const foo: string = 123; // 无任何错误提示

更危险的是，当一行代码包含多个逻辑时，@ts-ignore 会屏蔽整行的所有错误。比如函数名拼写错误、参数缺失等问题，都会被一并掩盖，给后续调试埋下隐患。

二、替代方案 1：@ts-expect-error（更智能的屏蔽注释）

@ts-expect-error 是 @ts-ignore 的 “升级版”，它的核心优势是 **“有条件生效”**：只有当下一行确实存在类型错误时，才会屏蔽错误；如果下一行没有错误，TypeScript 会主动提示 “该注释已无用”，避免冗余。

1. 效果对比

场景 1：存在错误时（两者效果一致）

// @ts-ignore

const foo1: string = 123; // 无错误提示

// @ts-expect-error

const foo2: string = 123; // 无错误提示

场景 2：无错误时（差异明显）

// @ts-ignore