在TypeScript中，应优先选择命名空间还是含静态方法的类？

你观察得很准——这两种写法在TypeScript层面的调用体验确实几乎一致（都是MyCollection.doSomething()），但背后的设计意图、生成的JS代码以及适用场景其实有不少区别，不完全是个人偏好的问题，我来帮你拆解一下：

一、先聊聊命名空间（Namespace） #

• 设计初衷：它是TypeScript早期为了解决全局作用域污染问题而生的，核心作用就是把相关的函数、变量打包到一个独立的命名空间下，避免和全局环境的其他变量冲突。
• 编译后的JS形态：会生成一个IIFE（立即执行函数表达式），把所有成员挂载到全局对象的MyCollection属性上，本质是一个普通的对象封装，没有多余的构造函数逻辑。
• 适用场景：如果你的项目还在使用全局脚本模式（没接入ES Modules），或者需要给全局环境暴露一组工具函数，命名空间是个不错的选择。不过现在ES Modules已经成为主流，它的使用场景已经大幅减少了。

二、再看静态类（Static Class） #

• 设计角度：它是借由类的语法来挂载静态方法，本质上还是基于面向对象的类概念，而非单纯的函数分组。
• 编译后的JS形态：会生成一个构造函数，静态方法被挂载到这个构造函数本身（不是原型链）。哪怕你完全不会实例化这个类，这个构造函数依然会存在于编译后的代码中。
• 避坑提醒：因为是类的写法，很容易让人误以为可以通过new MyCollection()来实例化它。如果你的类本来就不需要实例化，一定要加上private constructor()来禁止实例化，避免误解：

export class MyCollection {
  private constructor() {} // 防止被实例化
  public static doSomething(macguffin: any) {
    // todo: implement doSomething
  }
}

三、更推荐的现代方案 #

其实现在TypeScript社区最推崇的是ES Modules模块化方案，直接导出单个函数，而非用命名空间或静态类打包：

// my-collection.ts
export function doSomething(macguffin: any) {
  // todo: implement doSomething
}

使用时可以按需导入：

import { doSomething } from './my-collection';
doSomething(yourValue);

如果想要保留“分组调用”的感觉，也可以整体导入：

import * as MyCollection from './my-collection';
MyCollection.doSomething(yourValue);

这种方式完全符合现代JavaScript的模块化规范，编译后的代码更简洁，没有额外的封装开销，而且TypeScript对ES Modules的支持非常完善，是目前的最优解。

如果你非要二选一 #

• 若只是单纯封装一组纯函数，不需要任何类相关特性（比如继承、实例化），命名空间更合适——它就是为函数分组设计的，不会带来类的误解。
• 若你的代码本身就是面向对象体系，需要和其他类的静态方法交互，静态类更贴合你的代码风格，但务必记得加上私有构造函数防止实例化。

内容的提问来源于stack exchange，提问作者Chris_F