当前位置：首页 > 文章列表 > 文章 > 前端 > JavaScript单例模式使用详解

JavaScript单例模式使用详解

2026-02-25 16:00:47 0浏览收藏

JavaScript中的单例模式并非语法强制，而是一种需谨慎权衡的逻辑约束：它确保某类在整个应用生命周期中仅存在唯一实例，适用于配置管理、日志器等跨模块共享且状态轻量的场景，但绝不该滥用在需多实例或含副作用的组件上；文章深入剖析了从最简闭包实现到Symbol加固的进阶写法，直击懒加载竞争、异步初始化陷阱、模块重复导入导致单例失效等真实痛点，并强调——单例成败的关键不在代码技巧，而在于清醒界定“唯一性”的作用域边界：是当前执行上下文、模块实例，还是整个运行环境？想用好单例，先想清楚“为什么必须唯一”。

javascript设计模式有哪些_如何用单例模式创建唯一对象？

单例模式的核心判断：是否真需要全局唯一实例？

JavaScript 里 new 一个对象、用字面量 {} 或 Object.create(null) 都能快速创建对象，但“单例”不是语法限制，而是逻辑约束：确保整个应用生命周期中，某个类最多被初始化一次，且所有调用都返回同一个实例。别为了设计模式而单例——比如配置管理、日志器、状态仓库这类跨模块共享且无状态/轻状态的组件才适合；频繁创建不同参数的实例（如用户卡片、API 请求封装）硬套单例反而导致耦合和难以测试。

最简可行的单例实现：闭包 + 静态属性

ES6+ 环境下，用类配合静态属性是最直观的方式。关键点在于：实例缓存在类自身上，构造函数不直接暴露，而是通过静态方法控制创建时机。

class Logger {
  constructor() {
    if (Logger.instance) {
      return Logger.instance;
    }
    this.logs = [];
    Logger.instance = this;
  }

  static getInstance() {
    return Logger.instance || new Logger();
  }

  log(msg) {
    this.logs.push(`${new Date().toISOString()}: ${msg}`);
  }
}

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

注意：Logger.instance 是手动维护的引用，如果误删或重赋值（如 Logger.instance = null），下次调用 getInstance() 会新建实例，破坏单例性。生产环境建议加 Object.freeze(Logger) 锁定构造函数本身。

更健壮的写法：利用 `Symbol` 防止外部篡改

用 Symbol 作私有键名，避免 instance 被意外覆盖。同时把初始化逻辑收进静态 getter，让调用更自然。

class Database {
  constructor() {
    if (Database[Database.instanceSymbol]) {
      return Database[Database.instanceSymbol];
    }
    this.connection = 'fake-connection-string';
    Database[Database.instanceSymbol] = this;
  }

  static get instanceSymbol() {
    if (!Database._instanceSymbol) {
      Database._instanceSymbol = Symbol('db-instance');
    }
    return Database._instanceSymbol;
  }

  static get instance() {
    return Database[Database.instanceSymbol] || new Database();
  }
}

// 使用
const db1 = Database.instance;
const db2 = Database.instance;
console.log(db1 === db2); // true

这个版本的关键差异：

Symbol 键无法被 for...in 或 Object.keys() 枚举，外部代码几乎无法干扰
静态 get instance() 语法比 getInstance() 更符合直觉，也避免忘记加括号
仍需注意：若模块被多次 import（如在不同打包上下文），每个导入副本会拥有独立的 Symbol 和静态属性，此时单例失效——这是模块系统层面的问题，不是单例逻辑缺陷