Skip to main content

namespace 命名空间

命名空间一个最明确的目的就是解决重名问题,其定义了标识符的可见范围,一个标识符可在多个名字空间中定义,它在不同名字空间中的含义是互不相干的。

这样,在一个新的名字空间中可定义任何标识符,它们不会与任何已有的标识符发生冲突,因为已有的定义都处于其他名字空间中。

一、TypeScript 命名空间

TypeScript 中使用 namespace 来定义命名空间,语法格式如下:

namespace SomeNameSpaceName {
export interface ISomeInterfaceName {}
export class SomeClassName {}
}

以上定义了一个命名空间 SomeNameSpaceName,如果要在外部调用 SomeNameSpaceName 中的类和接口,则需要在类和接口添加 export 关键字。

在另外一个命名空间调用语法格式为:

SomeNameSpaceName.SomeClassName;

如果一个命名空间在一个单独的 TypeScript 文件中,则应使用三斜杠 /// 引用它:

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

命名空间本质上是一个对象,作用是将一系列相关的全局变量组织到一个对象的属性,如下:

namespace Letter {
export let a = 1
export let b = 2
export let c = 3
// ...
export let z = 26
}

编译成以下 JS 代码:

var Letter;
(function (Letter) {
Letter.a = 1
Letter.b = 2
Letter.c = 3
// ...
Letter.z = 26
})(Letter || (Letter = {}))

二、总结

命名空间是位于全局命名空间下的一个普通的带有名字的 JS 对象,使用起来十分容易。但就像其它的全局命名空间污染一样,它很难去识别组件之间的依赖关系,尤其是在大型的应用中。

在正常的 TS 项目开发过程中不建议用命名空间,通常在通过 d.ts 文件标记 JS 库类型的时候使用命名空间,主要作用:给编译器编写代码的时候参考使用。