JavaScript单例模式详解与应用

JavaScript单例模式的本质并非依赖语言特性，而是通过手动缓存实例来确保全局唯一引用——无论采用`getInstance()`静态方法封装初始化逻辑，还是更轻量的模块导出对象方式，核心都在于“复用同一实例”；文章深入剖析了两种主流实现的优劣、私有化构造的合理约定（而非不可靠的运行时拦截）、闭包或静态属性的安全缓存实践，并特别强调：真正健壮的单例必须配套显式的销毁机制，以避免定时器、DOM引用等导致的内存泄漏，让开发者在简洁性、可维护性与工程可靠性之间找到最佳平衡。

JavaScript 单例模式的核心判断：不靠 class 语法，靠实例缓存

JavaScript 里没有语言级的“单例类”概念，class 本身不阻止重复 new。所谓单例，本质是**手动控制构造逻辑，确保全局只返回同一个对象引用**。关键不在写法多“标准”，而在是否真正复用同一实例——哪怕用了 class，如果每次调用都 new，就不是单例。

getInstance() 是最可靠、最易理解的单例实现方式

把实例创建逻辑封装在静态方法里，首次调用时初始化并缓存，后续直接返回缓存值。这种方式清晰、可控、调试友好。

• 必须用闭包或静态属性缓存实例，不能依赖外部变量（否则模块间可能污染）
• 推荐使用 static 属性（ES2022+）或模块级私有变量，避免全局污染
• 构造函数应设为私有语义（如抛错或注释说明），但 JS 无法真正禁止 new，靠约定+文档约束

class Logger {
  static #instance = null;
  constructor() {
    if (Logger.#instance) {
      throw new Error('Use Logger.getInstance() instead');
    }
    this.logCount = 0;
  }
  static getInstance() {
    if (!Logger.#instance) {
      Logger.#instance = new Logger();
    }
    return Logger.#instance;
  }
  log(msg) {
    console.log(`[${++this.logCount}] ${msg}`);
  }
}

// 正确用法
const a = Logger.getInstance();
const b = Logger.getInstance();
console.log(a === b); // true

用模块导出替代 class 是更轻量、更常见的单例实践

多数场景下，单例本质就是一个“带状态的工具对象”。直接导出一个已初始化的对象，比包装一层 class 更简洁、无歧义、天然单例。

• 模块加载器（如 Node.js 或 ESM）保证每个模块路径只执行一次，导出对象天然唯一
• 无需 getInstance() 调用，直接 import 即用，减少心智负担
• 适合配置管理、日志器、HTTP 客户端等状态相对稳定的服务类对象

// logger.js
export const logger = {
  logCount: 0,
  log(msg) {
    console.log(`[${++this.logCount}] ${msg}`);
  }
};

// 使用方
import { logger } from './logger.js';
logger.log('start'); // [1] start

警惕基于 new.target 或 Symbol 的“防 new”陷阱

有人试图用 new.target 检测是否被 new 调用，或用 Symbol 作私有 token 阻止非法实例化。这些方案在真实工程中往往失效：

• new.target 在箭头函数、Reflect.construct、Babel 转译后可能行为异常
• Symbol 并非真正私有，可通过 Object.getOwnPropertySymbols() 暴露
• 过度防御反而让代码难读、难测，且无法阻止开发者绕过（比如直接修改缓存）

真正重要的不是“防住所有 new”，而是**让正确用法足够自然、错误用法一眼可见**。用命名（getInstance）、文档、TypeScript 类型提示（如将构造函数设为 private）来引导，比运行时硬拦更有效。

复杂点在于：单例的生命周期和销毁逻辑常被忽略。JS 没有析构机制，若单例持有 DOM 引用、定时器、事件监听器，需显式提供 destroy() 或清理方法，否则容易内存泄漏。

好了，本文到此结束，带大家了解了《JavaScript单例模式详解与应用》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！