Skip to content

条件类型分布产生意外结果

快速摘要

你的条件类型对联合类型是分布式的 —— 它对每个成员分别求值,产生结果的联合。

为什么发生

  • 条件类型操作裸类型参数(联合类型),触发分布

  • 你期望条件类型将联合作为整体求值但它对每个成员分布

  • 分布产生比预期单一类型更宽的联合类型

最小示例

✗ 错误代码
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] 包装防止它

  • 用联合和非联合输入测试条件类型以验证期望行为

相关资源

相关课程

← 返回语言