请解释 TypeScript 中的声明合并 (Declaration Merging) 的概念和规则

推荐答案

TypeScript 中的声明合并（Declaration Merging）是指编译器将多个同名的声明合并为一个单一的声明。这种机制允许开发者将分散在不同地方的声明组合在一起，从而扩展类型、接口、命名空间等的功能。

声明合并的类型

1. 接口合并：多个同名的接口声明会自动合并为一个接口，合并后的接口包含所有声明的成员。
2. 命名空间合并：同名的命名空间会合并为一个命名空间，合并后的命名空间包含所有声明的成员。
3. 函数合并：同名的函数声明会合并为一个函数，通常用于函数重载。
4. 枚举合并：同名的枚举会合并为一个枚举，合并后的枚举包含所有声明的成员。

声明合并的规则

1. 接口合并：合并时，同名属性必须类型相同，否则会报错。方法可以重载。
2. 命名空间合并：合并时，命名空间中的导出成员会合并，非导出成员不会合并。
3. 函数合并：合并时，函数签名会按照声明的顺序进行重载。
4. 枚举合并：合并时，枚举成员会合并，且不能有重复的枚举值。

本题详细解读

接口合并示例

// www.javascriptcn.com code example
interface Box {
    height: number;
}

interface Box {
    width: number;
}

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

命名空间合并示例

// www.javascriptcn.com code example
namespace MyNamespace {
    export const x = 1;
}

namespace MyNamespace {
    export const y = 2;
}

// 合并后的命名空间
namespace MyNamespace {
    export const x = 1;
    export const y = 2;
}

函数合并示例

function add(a: number, b: number): number;
function add(a: string, b: string): string;

function add(a: any, b: any): any {
    return a + b;
}

枚举合并示例

// www.javascriptcn.com code example
enum Direction {
    Up = "UP",
}

enum Direction {
    Down = "DOWN",
}

// 合并后的枚举
enum Direction {
    Up = "UP",
    Down = "DOWN",
}

注意事项

• 声明合并时，同名属性的类型必须一致，否则会报错。
• 命名空间合并时，非导出成员不会合并。
• 函数合并时，函数签名会按照声明的顺序进行重载。
• 枚举合并时，不能有重复的枚举值。