TypeScript(TSX)中如何让编译器忽略错误函数声明或指定代码行

遇到这种为了验证错误参数处理逻辑，需要临时绕开类型检查的场景太常见了，我给你几个实用的解决办法：

1. 使用// @ts-expect-error（推荐） #

比起// @ts-ignore，@ts-expect-error是测试场景下更优的选择——它明确告诉TypeScript「我预期这一行会触发类型错误」，而且如果后续代码修改让错误消失了，TS还会主动提示你这个注释已经多余，避免留下无用的忽略规则。

用法很简单，把它放在触发错误的代码行上方：

it('throws an error when invalid props are passed', () => {
  // @ts-expect-error 故意传入不符合Props类型的参数，验证错误处理逻辑
  expect(() => new CurvedMeter({ maxValue: 'not a number', width: 100 })).toThrow();
});

注意这个特性需要TypeScript 3.9及以上版本，如果你的TS版本较低，建议先升级到稳定的新版本。

2. 用any类型断言绕开检查 #

如果你不想用注释，也可以直接把测试用的错误参数断言为any，强制跳过TS的类型校验：

it('throws an error when invalid props are passed', () => {
  // 把错误参数断言为any，绕开类型检查
  const badProps = { maxValue: 'invalid', height: '100' } as any;
  expect(() => new CurvedMeter(badProps)).toThrow();
});

这种方式更直接，也不需要依赖特定TS版本，适合快速编写测试用例的场景。

3. 为什么// @ts-ignore没生效？ #

如果之前尝试// @ts-ignore没用，大概率是注释的位置不对——它必须放在错误代码行的上一行，不能和代码行同一行，也不能隔行。比如正确的写法是：

// @ts-ignore
new CurvedMeter({ invalidProp: 'test' });

而不是：

new CurvedMeter({ invalidProp: 'test' }); // @ts-ignore

不过还是更推荐用@ts-expect-error，因为它的语义更清晰，也能避免不小心忽略掉其他未预期的错误。

内容的提问来源于stack exchange，提问作者Andrew