TypeScript启用useUnknownInCatchVariables后，获取错误字符串表示的规范方法是什么？

这确实是TypeScript 4.4默认启用useUnknownInCatchVariables后，日常开发里超级常见的场景——毕竟之前catch里的error都是any类型，直接调用toString()完全没压力，现在突然要处理unknown，确实有点别扭。下面是几种符合规范、又不会触发TSLint警告的解决方案：

1. 用类型守卫做精准判断（最安全的方式） #

TypeScript推荐用类型收窄来处理unknown类型，我们可以先判断error的具体类型，再做对应的转换：

try {
  // 这里写你的业务代码
} catch (error) {
  let errStr: string;
  
  // 首先处理error本身就是字符串的情况
  if (typeof error === 'string') {
    errStr = error;
  }
  // 大部分情况下error是Error实例，直接调用toString()
  else if (error instanceof Error) {
    errStr = error.toString();
  }
  // 兜底处理其他所有情况，比如null、undefined或者自定义非Error对象
  else {
    errStr = String(error);
  }
  
  console.log(errStr);
}

这种方式完全符合严格模式的类型要求，不会有任何类型安全隐患，也能覆盖绝大多数实际场景。

2. 直接使用全局String()函数（最简洁的方式） #

如果你不需要做太精细的区分，全局的String()函数可以直接把任何unknown类型的值转换成字符串，它内部已经处理了所有边缘情况（比如null会转成"null"，undefined转成"undefined"，对象会调用其toString方法）：

try {
  // 这里写你的业务代码
} catch (error) {
  const errStr = String(error);
  console.log(errStr);
}

这行代码足够简洁，而且完全符合TypeScript的类型规范，不会触发任何警告，日常开发里用这个基本能解决90%以上的需求。

3. 封装一个通用工具函数（适合团队统一复用） #

如果你的团队经常需要处理这种场景，可以封装一个健壮的工具函数，统一处理所有可能的error类型：

function convertErrorToString(error: unknown): string {
  // 先处理字符串类型的error
  if (typeof error === 'string') {
    return error;
  }
  // 处理Error实例，还可以根据需要返回message或者stack
  if (error instanceof Error) {
    // 如果你想更详细，也可以返回`${error.message}\n${error.stack}`
    return error.toString();
  }
  // 尝试转成JSON，处理自定义对象类型的error
  try {
    return JSON.stringify(error);
  } catch {
    // 万一JSON.stringify失败（比如循环引用），用兜底方案
    return String(error);
  }
}

// 使用示例
try {
  // 这里写你的业务代码
} catch (error) {
  const errStr = convertErrorToString(error);
  console.log(errStr);
}

这个函数覆盖了更多边缘情况，适合团队内部统一使用，避免大家重复造轮子。

另外要提醒的是：尽量不要把error强制转换成any类型，虽然能快速解决问题，但会失去TypeScript的类型安全保障，这也是TSLint警告你的原因。

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