什么是命名空间？

命名空间（Namespace）是TypeScript提供的一种组织代码的方式。简单来说，它就像是一个抽屉或者文件夹，用来把相关的代码放在一起，避免命名冲突并保持代码整洁。

想象一下：在一个大办公室里，如果没有部门划分，所有人都混在一起工作，找人或讨论事情会很混乱。命名空间就是为代码创建这样的”部门划分”。

为什么需要命名空间？

💡 想象一下：你家里有两个人叫”小明”。当你叫”小明”时，两个人都会回应，这就产生了混乱。命名空间就像给每个人加上了姓氏，变成”张小明”和”李小明”，这样就不会混淆了。

  • 避免命名冲突 – 不同命名空间可以有相同名称的类/函数
  • 逻辑分组 – 把相关的代码组织在一起
  • 提高可维护性 – 代码结构更清晰
  • 封装代码 – 控制代码的可见性和访问权限

如何定义命名空间？

使用namespace关键字定义命名空间：

namespace MySpace {
    // 在这个命名空间内定义变量、函数、类等
    export function greet() {
        return "Hello from MySpace!";
    }
    
    export class Person {
        constructor(public name: string) {}
    }
}

📌 重要提示：使用export关键字将内容暴露给命名空间外部使用。没有export的内容只能在命名空间内部使用。

使用命名空间中的内容

使用命名空间名称.成员名称的方式访问：

// 使用命名空间中的函数
console.log(MySpace.greet()); // 输出: Hello from MySpace!

// 使用命名空间中的类
let person = new MySpace.Person("张三");
console.log(person.name); // 输出: 张三

命名空间的嵌套

你可以在一个命名空间中定义另一个命名空间：

namespace Company {
    export namespace HR {
        export function hire() {
            return "Hiring new employee...";
        }
    }
    
    export namespace IT {
        export function fixComputer() {
            return "Fixing computer issue...";
        }
    }
}

// 使用嵌套命名空间
console.log(Company.HR.hire()); // 输出: Hiring new employee...
console.log(Company.IT.fixComputer()); // 输出: Fixing computer issue...

🏢 类比：就像一家大公司下有不同部门（HR、IT等），每个部门有自己的职能。

多文件中的命名空间

命名空间可以跨多个文件：

文件1: shapes.ts

namespace Shapes {
    export class Circle { /* ... */ }
}

文件2: app.ts

/// <reference path="shapes.ts" />

let circle = new Shapes.Circle();

📌 注意：使用三斜线指令/// <reference path="..." />告诉TypeScript文件之间的依赖关系。

命名空间 vs 模块

特性 命名空间 模块
组织方式 逻辑分组 文件作用域
作用域 全局或命名空间内 模块作用域
加载方式 通过<script>标签顺序加载 使用模块加载器（如Webpack）
依赖管理 需要手动管理 自动处理
最佳使用场景 小型项目或客户端代码 中大型项目，特别是Node.js应用

💡 现代TypeScript开发中，模块通常是更好的选择，但对于某些场景（如库的声明文件）命名空间仍然有用。

命名空间的别名

当命名空间名称很长时，可以使用import创建别名：

namespace VeryLongNamespaceName {
    export function doSomething() { /* ... */ }
}

// 创建别名
import shortName = VeryLongNamespaceName;

shortName.doSomething(); // 使用别名调用

🏷️ 类比：就像给你的朋友”尼古拉斯·赵四”起个昵称叫”四哥”，更容易称呼。

命名空间的最佳实践

  • 使用有意义的名字，反映其功能（如Utilities、Models）
  • 避免过度嵌套（通常不超过2-3层）
  • 在跨文件使用时，注意文件加载顺序
  • 对于新项目，优先考虑使用模块
  • 在大型库的声明文件中(.d.ts)，命名空间是标准做法

⚠️ 注意：随着ECMAScript模块的普及，命名空间的使用已经减少。但在处理遗留代码或某些特定场景时，理解命名空间仍然很重要。

💻

实际应用示例：几何计算库

// 定义几何命名空间
namespace Geometry {
    const PI = Math.PI;
    
    // 导出圆形相关功能
    export namespace Circle {
        export function area(radius: number): number {
            return PI * radius * radius;
        }
        
        export function circumference(radius: number): number {
            return 2 * PI * radius;
        }
    }
    
    // 导出矩形相关功能
    export namespace Rectangle {
        export function area(width: number, height: number): number {
            return width * height;
        }
        
        export function perimeter(width: number, height: number): number {
            return 2 * (width + height);
        }
    }
}

// 使用几何库
console.log("Circle area:", Geometry.Circle.area(5));
console.log("Rectangle perimeter:", Geometry.Rectangle.perimeter(4, 6));