namespace vs module

在 TypeScript 1.5 版本之前， TS 中存在 内部模块 和 外部模块 的概念。但是从 1.5 开始，为了兼容 ES6 中的模块语法，将 内部模块 改为了 命名空间。而 外部模块 则称为 模块，此时的 模块（module） 概念与 ES6 中的 模块 保持一致。

namespace 介绍

namespace 的概念与module 非常相似，主要都用于组织代码。在实际的开发中推荐尽量使用 module 来满足需求。

namespace 引用方式

需要注意的是，namespace 之间引用的时候， 采用 /// <reference path="namespaceName.ts" /> 的语法来互相引用，而不遵循 module 中 import 规范。

namespace 主要场景

namespace 可以用于组织代码，聚合多个类等场景，但是此种场景推荐使用 ES6 module。不过当我们需要在类型声明文件（*.d.ts）中描述一个带有多个函数和属性的第三方库的时候，会使用到 namespace 。例如下方例子：

  1. /*~ If your library has properties exposed on a global variable,
  2.  *~ place them here.
  3.  *~ You should also place types (interfaces and type alias) here.
  4.  */
  5. declare namespace myLib {
  6.   //~ We can write 'myLib.timeout = 50;'
  7.   let timeout: number;
  9.   //~ We can access 'myLib.version', but not change it
  10.   const version: string;
  12.   //~ There's some class we can create via 'let c = new myLib.Cat(42)'
  13.   //~ Or reference e.g. 'function f(c: myLib.Cat) { ... }
  14.   class Cat {
  15.     Ï;
  16.     constructor(n: number);
  18.     //~ We can read 'c.age' from a 'Cat' instance
  19.     readonly age: number;
  21.     //~ We can invoke 'c.purr()' from a 'Cat' instance
  22.     purr(): void;
  23.   }
  25.   //~ We can declare a variable as
  26.   //~   'var s: myLib.CatSettings = { weight: 5, name: "Maru" };'
  27.   interface CatSettings {
  28.     weight: number;
  29.     name: string;
  30.     tailLength?: number;
  31.   }
  33.   //~ We can write 'const v: myLib.VetID = 42;'
  34.   //~  or 'const v: myLib.VetID = "bob";'
  35.   type VetID = string | number;
  37.   //~ We can invoke 'myLib.checkCat(c)' or 'myLib.checkCat(c, v);'
  38.   function checkCat(c: Cat, s?: VetID);
  39. }