一、namespace 是什么？核心作用：归类组织代码
namespace 是 TypeScript 早期为了解决代码模块化问题设计的语法，核心目的就是把相关的变量、函数、类、接口等代码集中放到一个独立的容器中，让代码结构更清晰，同时避免不同功能的代码在全局作用域中命名冲突。
简单来说，就是将同一类功能的代码整合在一起，容器内的代码默认仅能内部使用，想要对外暴露供外部调用，需要做专门的导出标记。
基础用法：定义命名空间并对外暴露成员
定义的命名空间内部成员，默认处于封闭状态，外部无法访问；只有添加export关键字的成员，才会被对外暴露，外部才能正常调用。
// 定义一个名为 Utils 的命名空间namespaceUtils{// 未加 export，仅能在 Utils 内部使用functionisString(value:any){returntypeofvalue==='string';}// 内部调用：正常执行isString('hello');}// 外部调用：报错！isString 未对外暴露Utils.isString('world');给需要对外使用的成员添加export，即可实现外部访问：
namespaceUtils{// 加 export 标记，对外暴露exportfunctionlog(msg:string){console.log(msg);}exportfunctionerror(msg:string){console.error(msg);}}// 外部可正常调用命名空间的导出成员Utils.log('执行打印操作');Utils.error('执行错误提示');编译后的实际形态
TypeScript 会将 namespace 编译为 JavaScript 的自执行函数 + 全局对象形式，所有添加export的成员，最终都会成为这个全局对象的属性：
// 编译后生成的 Utils 代码varUtils;(function(Utils){functionlog(msg){console.log(msg);}// 导出的成员挂载到全局对象 Utils 上Utils.log=log;})(Utils||(Utils={}));需要注意的是：namespace 并非纯类型语法，编译后会生成真实的 JavaScript 对象，占用运行时内存，这也是它和 ES 模块的重要区别。
二、namespace 常用实用技巧
1. 嵌套命名空间：精细化分类代码
如果代码功能分类更细致，可以在命名空间内部嵌套定义其他命名空间，实现多层级的代码组织。内层的命名空间如果需要对外暴露，同样要添加 export 关键字。
namespaceUtils{// 嵌套命名空间 Messaging，需加 export 对外暴露exportnamespaceMessaging{exportfunctionlog(msg:string){console.log(msg);}}}// 外部调用嵌套命名空间的成员：从最外层开始逐层访问Utils.Messaging.log('调用嵌套命名空间的方法');2. 为外部成员起别名：简化代码调用
如果外部命名空间的成员名称较长，或者调用路径繁琐，可以在当前作用域内用import为其起别名，简化后续调用，这种方式可用于命名空间内部或外部。
namespaceUtils{exportfunctionisString(value:any){returntypeofvalue==='string';}}namespaceApp{// 为 Utils.isString 起别名 isString，简化调用importisString=Utils.isString;// 直接使用别名，无需写完整的命名空间路径isString('使用别名调用方法');}3. 跨文件使用命名空间：三斜杠引用
如果一个命名空间的代码单独写在一个文件中，在其他文件中想要使用它，早期的写法是使用三斜杠引用语法，不过这种方式现在已经不推荐，更规范的方式是使用 ES 模块的 import 导入。
// 三斜杠引用 utils.ts 文件，引入其中的命名空间/// <reference path="./utils.ts" />// 直接使用 utils.ts 中定义的 Utils 命名空间Utils.log('跨文件调用命名空间成员');三、namespace 的核心特性：自动合并
多个同名的 namespace 会在编译时自动合并为一个整体，这是它的重要特性，适合对已有命名空间进行扩展，方便协作开发或修改他人代码。
// 第一个同名的 Animals 命名空间namespaceAnimals{exportclassCat{}}// 第二个同名的 Animals 命名空间namespaceAnimals{exportinterfaceLegged{numberOfLegs:number;}exportclassDog{}}// 上述两个命名空间，会自动合并为以下形式namespaceAnimals{exportinterfaceLegged{numberOfLegs:number;}exportclassCat{}exportclassDog{}}注意：只有添加export关键字的对外暴露成员会参与合并，非导出的内部成员仅能在自身所在的原命名空间中使用，合并后的命名空间无法访问。
namespaceN{// 非导出成员，仅能在当前 N 内部使用consta=0;exportfunctionfoo(){console.log(a);// 正常执行}}namespaceN{exportfunctionbar(){foo();// 正常执行，foo 是导出成员console.log(a);// 报错！a 是非导出成员，无法访问}}扩展特性：可与函数/类/枚举合并
namespace 还可以与同名的函数、类、枚举进行合并，实现为这些对象添加额外属性或方法的效果。注意：函数、类、枚举必须在同名命名空间之前声明。
1. 与函数合并：为函数添加属性
// 先声明函数functionf(){returnf.version;}// 同名命名空间为函数添加属性namespacef{exportconstversion='1.0';}// 调用函数console.log(f());// '1.0'// 访问函数的新增属性console.log(f.version);// '1.0'2. 与类合并：为类添加静态属性
// 先声明类classC{foo=1;}// 同名命名空间为类添加静态属性namespaceC{exportconstbar=2;}// 访问类的静态属性console.log(C.bar);// 23. 与枚举合并：为枚举添加方法
// 先声明枚举enumE{A,B,C}// 同名命名空间为枚举添加方法namespaceE{exportfunctionfoo(){console.log(E.C);// 2}}// 调用枚举的新增方法E.foo();// 2重要限制：枚举与同名命名空间合并时，枚举的成员和命名空间的导出成员不能重名，否则会直接编译报错。
四、为什么官方不推荐使用？首选 ES 模块的原因
namespace 是 ES 模块（import/export）出现之前的过渡性方案，如今 ES 模块已经成为 JavaScript 官方的模块化标准，能够完全替代 namespace，且在标准性、兼容性、灵活性上更有优势，这也是 TS 官方推荐使用 ES 模块的核心原因。
两者核心差异对比：
| 特性 | namespace | ES 模块（import/export） |
|---|---|---|
| 语法标准 | TypeScript 专属语法，需编译转换 | JavaScript 官方标准，无需额外编译 |
| 文件使用限制 | 一个文件中可定义多个命名空间 | 一个文件就是一个独立模块 |
| 运行时影响 | 编译后生成全局对象，占用运行时内存 | 纯模块化语法，无额外全局对象 |
| 环境兼容性 | 仅 TypeScript 环境支持，生态有限 | 所有 JavaScript/TypeScript 运行环境均支持 |
ES 模块替代 namespace 示例
原来使用 namespace 的写法，需要嵌套命名空间并多次导出：
// shapes.tsexportnamespaceShapes{exportclassTriangle{}exportclassSquare{}}使用 ES 模块的写法更简洁，直接导出成员即可，无需嵌套：
// shapes.ts 直接导出类，无额外嵌套exportclassTriangle{}exportclassSquare{}// 其他文件中导入使用import*asshapesfrom'./shapes';// 直接调用导入的成员constt=newshapes.Triangle();五、总结：什么时候用 namespace？
namespace 现在已经不是 TS 推荐的模块化方式了，日常开发里只在这几种情况用：
- 改老项目：老 TS 项目里用了很多 namespace，不用特意全改掉，保持兼容就行；
- 临时加全局属性：比如想给 window、Math 加个自定义方法，可临时用；
- 简单脚本归类：写少量不用模块化的简单代码时，用它避免全局变量重名。
新项目直接用 ES 模块（import/export）就好，这是官方推荐的标准写法，兼容更好、也更好维护。学 namespace 主要是为了能看懂老代码，日常维护够用就行。
