JavaScript单例模式核心是手动缓存实例确保全局唯一,推荐getInstance()方法或模块导出对象;构造函数应私有化约定,避免依赖new.target等不可靠防护,需关注内存泄漏并提供销毁机制。

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 阻止非法实例化。这些方案在真实工程中往往失效:
立即学习“Java免费学习笔记(深入)”;
-
new.target在箭头函数、Reflect.construct、Babel 转译后可能行为异常 -
Symbol并非真正私有,可通过Object.getOwnPropertySymbols()暴露 - 过度防御反而让代码难读、难测,且无法阻止开发者绕过(比如直接修改缓存)
真正重要的不是“防住所有 new”,而是**让正确用法足够自然、错误用法一眼可见**。用命名(getInstance)、文档、TypeScript 类型提示(如将构造函数设为 private)来引导,比运行时硬拦更有效。
复杂点在于:单例的生命周期和销毁逻辑常被忽略。JS 没有析构机制,若单例持有 DOM 引用、定时器、事件监听器,需显式提供 destroy() 或清理方法,否则容易内存泄漏。











