TypeScript中如何将嵌套接口转换为类型别名？

要解决嵌套接口无法赋值给索引签名类型的问题，你需要递归地将所有层级的接口转换为类型别名结构，消除TypeScript对接口的“精确类型”校验。仅浅拷贝顶层属性（比如用Pick）无法处理嵌套的接口，必须遍历所有嵌套层级进行转换。

解决方案：递归类型转换工具 #

创建一个递归的映射类型，将目标接口的每一层属性都转换为类型别名：

// 递归转换接口为类型别名的工具类型
type ConvertToAlias<T> = {
  [K in keyof T]: T[K] extends object ? ConvertToAlias<T[K]> : T[K]
};

这个工具类型会遍历T的所有属性：

• 如果属性值是对象/接口类型，就递归转换该属性的内部结构
• 如果是基础类型（如string），则直接保留类型

结合示例代码的完整实现 #

interface InnerIObj {
  b: string;
}

interface IObj {
  x: {
    a: string;
  } & InnerIObj;
}

type IndexSignature = {
  [key: string]:
    | IndexSignature
    | string
};

declare const obj: IObj;

// 递归转换整个IObj为类型别名结构
type TObj = ConvertToAlias<IObj>;

const objAlias: TObj = obj;

// 现在可以正常赋值，无类型错误
const success: IndexSignature = objAlias;

为什么原方法无效？ #

原代码中的type TObj = Pick<IObj, keyof IObj>仅复制了顶层属性的键，但嵌套的x属性仍然是{a: string} & InnerIObj的接口交叉类型，TypeScript仍将其视为精确的接口类型，因此无法兼容宽松的索引签名类型。递归转换后，所有嵌套结构都变为类型别名的映射结构，符合索引签名的类型要求。

内容的提问来源于stack exchange，提问作者Magnus