JavaScript构造函数实现单例模式的核心是多次new返回同一对象引用,关键在于构造函数内检查静态实例缓存并显式return;推荐优先使用ES6模块天然单例,其次私有静态字段+getInstance方法。

JavaScript 中构造函数实现单例模式,核心不是“禁止 new”,而是让多次 new 调用始终返回同一个对象引用。关键在于拦截构造过程,检查实例是否已存在,存在就直接返回它,跳过新建逻辑。
在构造函数内部做实例判断(最常用)
利用构造函数自身的静态属性缓存实例,首次 new 时创建并保存,后续 new 直接返回该缓存值:
- 在 constructor 中检查 Class.instance 是否已存在
- 如果存在,return Class.instance(注意:必须显式 return 对象,否则 new 会返回新对象)
- 如果不存在,初始化实例并赋值给 Class.instance,再返回 this
示例:
class Database {
constructor() {
if (Database.instance) {
return Database.instance;
}
this.connectionId = Math.random();
Database.instance = this;
}
connect() {
console.log(`Connected with ID: ${this.connectionId}`);
}
}
const db1 = new Database();
const db2 = new Database();
console.log(db1 === db2); // true
db1.connect(); // Connected with ID: 0.123...
db2.connect(); // Connected with ID: 0.123...(同一实例)
配合私有静态字段(ES6+ 推荐写法)
使用 #instance 私有字段 + 静态方法 getInstance,语义更清晰,避免外部误操作静态属性:
立即学习“Java免费学习笔记(深入)”;
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 定义私有静态字段 #instance = null
- 提供静态方法 getInstance(),内部检查并创建
- 构造函数不强制私有(JS 无真正 private 构造器),但约定只通过 getInstance 获取
示例:
class Cache {
#data = new Map();
static #instance = null;
static getInstance() {
if (!Cache.#instance) {
Cache.#instance = new Cache();
}
return Cache.#instance;
}
set(key, value) {
this.#data.set(key, value);
}
get(key) {
return this.#data.get(key);
}
}
const c1 = Cache.getInstance();
const c2 = Cache.getInstance();
c1.set('theme', 'dark');
console.log(c2.get('theme')); // 'dark'
模块级天然单例(最自然、推荐优先采用)
ES6 模块本身具有单例特性:无论 import 多少次,模块脚本只执行一次,导出对象始终是同一引用。无需手动管理实例状态:
- 在模块文件中创建实例并导出
- 所有 import 该模块的地方拿到的都是同一个对象
- 完全规避构造函数控制逻辑,简洁安全
示例(logger.js):
class Logger {
constructor() {
this.count = 0;
}
log(msg) {
console.log(`[${++this.count}] ${msg}`);
}
}
// 模块顶层直接导出唯一实例
export default new Logger();
使用时:
import logger1 from './logger.js'; import logger2 from './logger.js'; console.log(logger1 === logger2); // true
注意事项与边界情况
这类构造函数单例不是绝对安全的“锁死”,需注意:
- 无法阻止开发者手动删除 Class.instance 后再次 new
- 若类有参数且需不同配置,需扩展为懒加载或带参工厂逻辑
- 测试时可能因全局状态影响隔离性,建议配合依赖注入或重置机制
- 模块方式最稳妥;闭包或静态字段方式适合需要延迟初始化或封装私有逻辑的场景

















