TypeScript中能否实现两个对象类型的深层递归交叉以约束共有属性?
TypeScript 实现对象类型深层交叉的方案
原生交叉操作符的局限性
TypeScript 自带的&交叉操作符实现的是浅层级的类型合并,不会做递归的共同属性筛选。以你给出的业务场景为例:
- 直接写
let locale: typeof en & typeof hu时,推导得到的类型会保留en里独有的welcome.world属性,TypeScript不会对访问该属性抛出类型错误,和“仅允许访问所有语言包共同存在属性”的需求完全不匹配。
原生交叉类型的核心逻辑是把两个类型的所有属性做并集,对同名属性做类型值的交叉,不会筛掉单类型独有的属性。
自定义递归深层交叉工具类型
可以通过TypeScript的映射类型、条件类型实现递归属性筛选的深层交叉逻辑,完全匹配你的需求:
type DeepIntersection<T, U> = T extends object ? U extends object ? { // 仅保留两个类型共有的属性键 [K in Extract<keyof T, keyof U>]: // 对每个共同属性的值递归执行深层交叉逻辑 DeepIntersection<T[K], U[K]> } : never : T & U;
方案验证
把你业务里的两个语言包对象套入这个类型做校验:
- 先定义两个带精确字面量类型的语言包常量(加
as const保留属性的字面量类型,避免被推导成宽泛的string类型):
const en = { "welcome": { "hello": "Hello", "world": "World" } } as const; const hu = { "welcome": { "hello": "Helló világ" } } as const;
- 构造深层交叉得到的共享语言类型:
type SharedLocale = DeepIntersection<typeof en, typeof hu>; // 实际推导结果等价于: // type SharedLocale = { // welcome: { // hello: "Hello" | "Helló világ" // } // }
- 类型访问校验:
- 访问
locale.welcome.hello:完全符合类型要求,正常通过校验 - 访问
locale.welcome.world:TypeScript 会直接抛出“属性不存在”的类型错误,完全满足业务约束。
扩展能力
如果需要支持多个语言包的批量深层交叉,可以把工具类型改成可变参数的递归版本:
type DeepIntersectionAll<T extends unknown[]> = T extends [infer First, ...infer Rest] ? DeepIntersection<First, DeepIntersectionAll<Rest>> : unknown;
这个版本可以传入任意长度的语言包类型数组,递归计算出所有语言包共有的属性结构。
针对你项目里通过Webpack alias动态切换多语言包的场景,这个类型可以作为全量语言包的结构校验依据:只要某个被alias指向的语言包没有覆盖所有共享属性,就会在编译阶段抛出类型错误,提前发现漏翻译的问题,不需要等到运行时才暴露文案缺失的异常。
内容的提问来源于stack exchange,提问作者Balázs Orbán
相关产品推荐
相关产品推荐

