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

推荐答案

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

声明合并的类型

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

声明合并的规则

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

本题详细解读

接口合并示例

-- -------------------- ---- -------
--------- --- -
    ------- -------
-

--------- --- -
    ------ -------
-

-- ------
--------- --- -
    ------- -------
    ------ -------
-

命名空间合并示例

-- -------------------- ---- -------
--------- ----------- -
    ------ ----- - - --
-

--------- ----------- -
    ------ ----- - - --
-

-- --------
--------- ----------- -
    ------ ----- - - --
    ------ ----- - - --
-

函数合并示例

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

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

枚举合并示例

-- -------------------- ---- -------
---- --------- -
    -- - -----
-

---- --------- -
    ---- - -------
-

-- ------
---- --------- -
    -- - -----
    ---- - -------
-

注意事项

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