JavaScript单例模式详解与实现

本文深入解析了JavaScript中实现单例模式的三种主流方式：基于闭包与静态属性的构造函数守卫（兼容性好、逻辑清晰）、利用ES6模块天然单例特性的推荐方案（简洁安全、零侵入、支持Tree-shaking），以及借助Symbol和WeakMap实现的高封装性私有单例（适合强约束场景）；同时明确指出全局变量硬绑定的危害并予以摒弃——帮你避开陷阱，用对的方法在JS生态中真正落地“全局唯一实例”这一经典设计思想。

JavaScript 中实现单例模式的核心是：**控制构造函数只能返回同一个实例，且该实例在全局唯一**。由于 JS 没有原生的私有构造器或静态类限制，需借助闭包、模块作用域或静态属性手动“封住”重复创建的路径。

用闭包 + 静态属性封装实例

这是最常用、兼容性好、逻辑清晰的方式。把实例缓存在构造函数自身的属性上，首次调用时创建，之后直接返回缓存值：

class Logger {
  constructor() {
    if (Logger.instance) {
      return Logger.instance;
    }
    this.logCount = 0;
    Logger.instance = this;
  }

  log(msg) {
    console.log(`[${++this.logCount}] ${msg}`);
  }
}

// 使用
const a = new Logger();
const b = new Logger();
console.log(a === b); // true

⚠️注意：这种方式依赖开发者不手动删除 Logger.instance，也不用 new Logger().constructor 绕过——它不是绝对安全，但足够应对常规场景。

用模块模式（ES6 Module）天然单例

利用 ES6 模块的“单例加载”特性：一个模块文件无论被 import 多少次，都只执行一次，导出对象始终是同一引用：

// logger.js
class Logger {
  constructor() {
    this.logCount = 0;
  }
  log(msg) {
    console.log(`[${++this.logCount}] ${msg}`);
  }
}

export default new Logger(); // 直接导出实例

// app.js
import logger from './logger.js';
import logger2 from './logger.js';

console.log(logger === logger2); // true

✅ 这是最推荐的方式：无需判断、无污染构造函数、天然防多例，适合配置类、工具类、状态管理器等。

用 Symbol + WeakMap 实现真正私有单例（进阶）

若需严格防止外部篡改实例（如测试环境或强约束库），可用 Symbol 作私有键，配合 WeakMap 存储实例，确保只有授权方法能访问：

const instanceKey = Symbol('singletonInstance');
const instances = new WeakMap();

class Database {
  constructor() {
    if (instances.has(this)) {
      return instances.get(this);
    }
    // 初始化逻辑
    this.connected = false;
    instances.set(this, this);
  }

  connect() {
    if (!this.connected) {
      console.log('Connected to DB');
      this.connected = true;
    }
  }
}

// 工厂函数提供受控入口
export const getDatabase = () => {
  const db = new Database();
  return db;
};

这种写法避免了在类上挂属性，更“干净”，但日常开发中略显冗余，适合对封装性要求极高的基础库。

不推荐的做法：全局变量硬绑定

像 window.mySingleton = new SomeClass() 或 globalThis.singleton = … 看似简单，但会污染全局命名空间、难以维护、无法 Tree-shaking、不利于模块化和测试。

• 破坏模块封装性
• 多个包可能冲突命名
• 服务端（Node.js）中 globalThis 行为与浏览器不一致
• 无法按需加载或懒初始化

应优先选择模块导出或构造器守卫方式。

到这里，我们也就讲完了《JavaScript单例模式详解与实现》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！