如何在TypeScript中声明可抛出错误的函数？实现Java式无处理调用

好问题！咱们先把需求拆解清楚：你在Java里可以给方法加上throws Exception声明，调用时不用非得用try/catch包裹（要么继续抛出，要么直接调用让上层处理），现在想知道TypeScript能不能做到同样的效果，而且你当前遇到了TS编译器强制要求try/catch的情况，对吧？

先明确TypeScript的异常机制 #

首先得说：TypeScript本身没有Java那种“checked exception（检查型异常）”的语言特性。Java里的throws是语言层面强制要求调用者处理的，但TS里所有异常都是“unchecked（非检查型）”的——也就是说，不管你的函数会不会抛出异常，调用它的时候编译器都不会强制你用try/catch包裹。

比如你直接写这样的TS代码，完全没问题，编译器不会报错：

function test(test: boolean): boolean {
  if (test === true) return false;
  throw new Error("Something went wrong");
}

// 直接调用，不需要try/catch，编译器不拦你
test(false);

如何在TS里“声明”函数会抛出异常（类似Java的throws） #

如果你想在函数签名里明确标注它可能抛出异常（给其他开发者或IDE看），可以用JSDoc的@throws标签，这样IDE会给出提示，但不会强制你处理：

/**
 * 测试布尔值的函数
 * @param test 要测试的布尔参数
 * @returns 如果test为true则返回false
 * @throws {Error} 如果test为false则抛出异常
 */
function test(test: boolean): boolean {
  if (test === true) return false;
  throw new Error("Test failed");
}

// 直接调用就行，编译器不报错，IDE会提示你这个函数可能抛出异常
test(false);

为什么你会遇到编译器强制要求try/catch的情况？ #

如果你当前的TS项目里调用这类函数必须加try/catch，大概率是用了第三方的checked异常库（比如ts-checked-exceptions）——这类库通过TypeScript的类型系统模拟了Java的检查型异常机制，所以会强制你处理异常。

如果想回到“无需处理即可调用”的状态，有两个选择：

• 移除这类第三方库，用TS原生的非检查异常机制；
• 用库提供的“跳过检查”的方式调用（比如某些库会提供unsafeCall之类的工具函数）。

总结 #

• TS原生不强制处理任何异常，所以抛出异常的函数默认就可以直接调用，不用try/catch；
• 用JSDoc的@throws可以实现类似Javathrows的“声明异常”效果，仅做提示不做强制；
• 若遇到强制要求try/catch的情况，检查是否使用了模拟checked异常的第三方库，再对应调整即可。

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