You need to enable JavaScript to run this app. 为什么TypeScript将使用自定义类型守卫的变量判定为never类型?
优惠活动
大模型
产品
解决方案
定价
更多

为什么TypeScript将使用自定义类型守卫的变量判定为never类型?

问题原因

你遇到的never类型报错是两个因素共同作用导致的:

  1. 空类的结构类型兼容问题:你定义的DomainError、CommandNotFound都是未添加任何独有属性、方法的空类,TypeScript默认采用结构类型系统做兼容性校验,会认为这两个类的结构和父类Error完全一致,类型收窄时会出现逻辑误判。
  2. 类型守卫入参范围不匹配:你写的isCommandNotFound自定义类型守卫的入参类型是Error,但调用时传入的参数是更窄的DomainError类型。当守卫返回false时,TypeScript会尝试推导error是「不属于CommandNotFound的DomainError」,但受空类结构兼容的影响,TS 认为这个集合不存在有效类型,最终推导为never。

而直接使用instanceof CommandNotFound判断没有问题,是因为TypeScript对内置的instanceof运算符的类型收窄逻辑做了特殊适配,不会触发空类的兼容误判。

解决方案

最优方案:缩小类型守卫的入参范围

将类型守卫的入参类型修改为和调用时一致的DomainError即可解决:

const isCommandNotFound = (subject: DomainError): subject is CommandNotFound => subject instanceof CommandNotFound

其他可选方案

如果后续还需要在DomainError之外的场景使用这个类型守卫,可以给自定义错误类添加独有标识属性,破坏结构兼容性:

class DomainError extends Error {
  // 添加唯一标识字段,覆盖父类的name属性
  override name = 'DomainError' as const
}

class CommandNotFound extends DomainError {
  override name = 'CommandNotFound' as const
}

修改后原类型守卫不需要调整也能正常收窄类型。


内容的提问来源于stack exchange,提问作者Moti

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 11:03:04