TS中的命名空间（Namespace）

在 TypeScript 中，命名空间（Namespace） 是一种用于组织代码的方式，它可以帮助我们将相关的类型、接口、类、函数等封装在一起，从而避免命名冲突，并提供一种模块化的结构。命名空间在 TypeScript 中主要用于以下目的：

1. 避免命名冲突

在大型项目中，可能会出现多个模块或文件中定义了相同名称的变量、函数或类型。通过使用命名空间，可以将这些内容封装起来，避免它们之间的冲突。例如：

// 文件1: math.ts
export namespace Math {
  export function add(a: number, b: number) {
    return a + b;
  }
}

// 文件2: string.ts
export namespace String {
  export function add(a: string, b: string) {
    return a.concat(b);
  }
}

// 使用时
import { Math, String } from './math';   //引入命名空间
import { String } from './string';

console.log(Math.add(1, 2)); // 输出：3
console.log(String.add("Hello", "World")); // 输出："HelloWorld"

如果没有命名空间，add 函数可能会因为名称冲突而无法正确区分。

2. 模块化代码

命名空间可以帮助我们将代码划分为逻辑模块，每个模块都有自己的命名空间。这样可以提高代码的可维护性和可读性。例如：

namespace UserModule {
  export interface User {
    id: number;
    name: string;
  }

  export function getUser(id: number): User {
    return { id, name: `User ${id}` };
  }
}

namespace AdminModule {
  export interface Admin extends UserModule.User {
    role: string;
  }

  export function getAdmin(id: number): Admin {
    return { id, name: `Admin ${id}`, role: 'admin' };
  }
}

在这个例子中，UserModule 和 AdminModule 是两个不同的命名空间，分别封装了用户和管理员相关的类型和函数。

3. 内部模块化

命名空间也可以用于在单个文件中组织代码，避免全局变量污染。例如：

namespace App {
  export namespace Config {
    export const version = '1.0.0';
  }

  export namespace Features {
    export function featureA() {
      console.log('Feature A');
    }
  }
}

console.log(App.Config.version); // 输出：1.0.0
App.Features.featureA(); // 输出：Feature A

4. 模拟模块行为

在早期的 TypeScript 中，命名空间被广泛用于模拟模块行为，尤其是在没有 ES6 模块支持的环境中。虽然现代 TypeScript 更推荐使用 ES6 模块（import 和 export），但命名空间仍然在某些场景下非常有用，例如在需要向后兼容旧代码时。

5. 声明合并

命名空间的一个重要特性是 声明合并。如果多个命名空间具有相同的名称，TypeScript 会将它们合并为一个命名空间。例如：

namespace MyNamespace {
  export const value1 = 10;
}

namespace MyNamespace {
  export const value2 = 20;
}

console.log(MyNamespace.value1); // 输出：10
console.log(MyNamespace.value2); // 输出：20

在这种情况下，MyNamespace 包含了 value1 和 value2，就好像它们是在同一个命名空间中定义的一样。

6. 全局扩展

命名空间还可以用于扩展全局对象。例如，可以扩展 window 对象：

declare namespace NodeJS {
  interface Global {
    myGlobalVar: string;
  }
}

global.myGlobalVar = 'Hello, World!';
console.log(global.myGlobalVar); // 输出：Hello, World!

总结

命名空间在 TypeScript 中是一种强大的工具，用于组织代码、避免命名冲突、模拟模块行为以及扩展全局对象。虽然现代 TypeScript 更倾向于使用 ES6 模块，但在某些场景下，命名空间仍然是非常有用的。