如何在TypeScript中显式声明泛型函数的Validator类型
之前的写法失效,本质是类型注解里的泛型没有合法的声明作用域:
当你写const isNotNull: Validator<T | null, T>时,TS会优先解析左侧的类型注解,这个阶段还没执行到右侧函数实现上的<T>泛型声明,对TS来说这里的T是完全没有来源的未知类型,自然会抛出“泛型参数在定义前使用”的错误。
另外还有个容易混淆的点:你定义的Validator<TInput, TOutput>是填完类型参数后的、固定输入输出的单态函数类型,但isNotNull本身是一个可以适配任意类型T的泛型函数——它不是某一个固定的Validator<X, Y>实例,而是能根据传入值的类型,自动匹配对应校验逻辑的泛型结构。如果直接把实例化后的Validator类型硬塞到注解位置,本身也和泛型函数的类型层级不匹配。
方案1:把泛型声明移到类型注解位置
要让TS识别到注解里的T是函数自身的泛型,必须把<T>的声明提到左侧的类型注解段,让TS在解析注解阶段就明确这是一个泛型函数:
const isNotNull: <T>(value: T | null) => Validated<T> = (value) => { // 具体校验逻辑 if (value === null) { return { ok: false, error: '值不能为null' }; } return { ok: true, value }; };
这个写法的类型签名和Validator<T | null, T>的结构完全等价,TS会严格校验右侧实现的入参、返回值是否符合约束,达到你要的强类型检查效果。把isNotNull传给后续的validate函数时,TS也能正常完成跨函数的泛型推导,不会丢失类型精度。
方案2:用辅助函数减少重复写签名
如果你不想手动重复一遍Validator的结构定义,可以写一个极轻量的类型辅助函数,自动完成类型匹配校验,同时完整保留函数的泛型特性:
// 通用Validator声明的辅助函数 function defineValidator<TInput, TOutput extends TInput>( validator: Validator<TInput, TOutput> ): Validator<TInput, TOutput> { return validator; } // 声明isNotNull时直接传入实现即可 const isNotNull = defineValidator( <T>(value: T | null): Validated<T> => { if (value === null) { return { ok: false, error: '值不能为null' }; } return { ok: true, value }; } );
这个写法完全不会丢失Validator的强类型约束:TS会自动校验你传入的函数是不是符合Validator的签名要求,写错了会直接抛类型错误。同时因为defineValidator本身会保留传入函数的泛型参数,把isNotNull传给validate函数做参数校验时,泛型推导链路是完全通畅的,很适合业务里大量定义校验函数的场景,能减少重复的类型注解代码。
不要为了省事把isNotNull声明为固定参数的宽泛Validator类型,比如const isNotNull: Validator<unknown, unknown> = ...——这种写法会把函数的泛型特性完全抹掉,后续在validate函数里调用时,TS无法推导出正确的TInput和TOutput类型,会直接丢失强类型校验的意义。
内容的提问来源于stack exchange,提问作者Duncan Lukkenaer

