为什么TypeScript将使用自定义类型守卫的变量判定为never类型?
问题原因
你遇到的never类型报错是两个因素共同作用导致的:
- 空类的结构类型兼容问题:你定义的
DomainError、CommandNotFound都是未添加任何独有属性、方法的空类,TypeScript默认采用结构类型系统做兼容性校验,会认为这两个类的结构和父类Error完全一致,类型收窄时会出现逻辑误判。 - 类型守卫入参范围不匹配:你写的
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
相关产品推荐
相关产品推荐

