条件类型分布产生意外结果
快速摘要
你的条件类型对联合类型是分布式的 —— 它对每个成员分别求值,产生结果的联合。
为什么发生
条件类型操作裸类型参数(联合类型),触发分布
你期望条件类型将联合作为整体求值但它对每个成员分布
分布产生比预期单一类型更宽的联合类型
最小示例
✗ 错误代码
type ToArray<T> = T extends any ? T[] : never;
type Result = ToArray<string | number>; // string[] | number[], not (string | number)[]✓ 修复代码
type ToArrayNonDist<T> = [T] extends [any] ? T[] : never;
type Result = ToArrayNonDist<string | number>; // (string | number)[]将 T 包装在 [T] 中防止条件类型对联合分布,给出单一数组类型而非数组的联合。
如何诊断
悬停类型别名使用处查看完全展开的分布结果
将类型参数包装在元组 [T] 中防止分布并查看非分布结果
用联合输入和单一类型输入测试条件类型以理解分布行为
如何修复
将类型参数包装在元组中防止分布:type NonDist<T> = [T] extends [Condition] ? A : B
如果希望条件应用于组合类型则使用交集类型而非联合类型
如果分布是期望行为则重新设计条件类型显式处理联合成员
如何预防
理解条件类型对裸类型参数分布 —— 使用 [T] 包装防止它
用联合和非联合输入测试条件类型以验证期望行为
相关资源
相关术语
相关课程
- 条件类型
学习条件类型。