TypeScript 基础指南：声明合并（Declaration Merging）

声明合并（Declaration Merging）是 TypeScript 中一个非常强大的特性,它允许开发者通过合并不同的声明来定义更加复杂和灵活的类型。在 TypeScript 中,当你声明具有相同名称的实体(如接口、命名空间、类、函数等)时,编译器会自动将它们合并为一个单一的声明。这种合并行为被称为声明合并。声明合并有以下几种类型:

接口合并

•

当多个接口具有相同名称时,它们的成员会被合并到一个接口中。

•

如果出现属性名冲突,则后定义的属性会覆盖先前的属性。

interface Box {
  height: number;
  width: number;
}

interface Box {
  scale: number;
}

// 合并后的 Box 接口:
// interface Box {
//   height: number;
//   width: number;
//   scale: number;
// }

命名空间合并

•

当多个具有相同名称的命名空间被声明时,它们的内容会被合并到一个命名空间中。

•

命名空间的成员(如函数、类、枚举等)会被合并到一个命名空间中。

namespace Animals {
  export class Zebra {}
}

namespace Animals {
  export class Elephant {}
}

// 合并后的 Animals 命名空间:
// namespace Animals {
//   export class Zebra {}
//   export class Elephant {}
// }

函数和命名空间合并

•

当一个函数声明和一个同名的命名空间被声明时,它们会被合并为一个拥有命名空间功能的函数对象。

•

命名空间的成员(如属性、函数等)会被添加到函数对象上。

function shaped(name: string) {
  console.log(`The shape's name is ${name}.`);
}

namespace shaped {
  export let numberOfEdges = 4;

  export function drawSquare(name: string) {
    console.log(`Drawing a square named ${name}!`);
  }
}

// 合并后的 shaped 函数:
// function shaped(name: string) {
//   console.log(`The shape's name is ${name}.`);
// }
// shaped.numberOfEdges = 4;
// shaped.drawSquare = (name: string) => {
//   console.log(`Drawing a square named ${name}!`);
// };