使用 TypeScript 命名空间

TypeScript 命名空间提供了一种在单个全局范围内组织和管理代码的方法。命名空间有助于将相关代码分组在一起，防止命名冲突，并提高代码的可维护性。本指南通过示例介绍了创建和使用 TypeScript 命名空间的基础知识。

什么是 TypeScript 命名空间？

命名空间是 TypeScript 中封装代码的一种方式。它们允许将相关函数、类和变量分组到单个逻辑单元中，这在大型项目中非常有用，可以避免命名冲突并改善代码组织。

创建命名空间

要创建命名空间，请使用 namespace 关键字，后跟名称和代码块。在命名空间块内，定义应属于该命名空间的函数、类或变量。

// mathUtils.ts

namespace MathUtils {
  export function add(a: number, b: number): number {
    return a + b;
  }

  export function subtract(a: number, b: number): number {
    return a - b;
  }
}

在这个例子中，MathUtils 命名空间包含两个函数，add 和 subtract，它们都被导出以供命名空间之外使用。

使用命名空间

要在命名空间内使用代码，请在命名空间名称前加上一个点号和成员名称。确保命名空间在使用的范围内可用。

// app.ts

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

const sum = MathUtils.add(5, 3);
const difference = MathUtils.subtract(5, 3);

console.log(`Sum: ${sum}`);
console.log(`Difference: ${difference}`);

在此示例中，使用三斜杠指令 '<reference path="mathUtils.ts" />' 引用 MathUtils 命名空间，从而允许在 app.ts 文件中访问其函数。

嵌套命名空间

命名空间可以嵌套在其他命名空间中，这有助于进一步组织代码。嵌套命名空间可以通过用点连接命名空间名称来访问。

// shapes.ts

namespace Shapes {
  export namespace Circle {
    export function area(radius: number): number {
      return Math.PI * radius * radius;
    }
  }

  export namespace Square {
    export function area(side: number): number {
      return side * side;
    }
  }
}

在这个例子中，Shapes 命名空间包含两个嵌套命名空间：Circle 和 Square，每个命名空间都有自己的 area 函数。

使用嵌套命名空间

要访问嵌套命名空间的成员，请使用点符号链接命名空间名称。

// app.ts

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

const circleArea = Shapes.Circle.area(5);
const squareArea = Shapes.Square.area(4);

console.log(`Circle Area: ${circleArea}`);
console.log(`Square Area: ${squareArea}`);

在此示例中，通过 Shapes 命名空间访问 Circle 和 Square 命名空间，演示了如何使用嵌套命名空间。

结论

TypeScript 命名空间是组织和管理代码的强大工具。通过使用命名空间，可以按逻辑对代码进行分组，从而降低命名冲突的风险并提高可维护性。了解如何创建和使用命名空间（包括嵌套命名空间）对于有效的 TypeScript 开发至关重要。