JavaScript单例模式实现详解

JavaScript虽无法通过类语法强制实现单例，但可通过私有静态字段（如#instance）配合getInstance()工厂方法、构造器守卫及初始化状态标记，安全可靠地构建真正受控的单例；兼容旧环境时可用WeakMap或静态对象模拟，支持惰性带参初始化，并需注意模块级单例优势、测试可替换性及跨Worker隔离等实际陷阱——掌握这些细节，才能写出既健壮又灵活的单例实现。

JavaScript中无法直接通过类语法强制保证单例，但可以借助静态属性和闭包逻辑，在构造函数中控制实例的唯一性。核心思路是：类内部维护一个私有静态引用，首次调用时创建实例并缓存，后续调用直接返回该实例。

基础实现：静态实例 + 构造器拦截

利用 static 属性保存实例，并在 constructor 中检查是否已存在。若已存在，抛出错误或直接返回（注意：new 关键字无法跳过构造器，所以需配合工厂方法）。

更合理的方式是把构造器设为私有（靠约定或 Symbol 隐藏），只暴露一个静态获取方法：

• 用 static #instance（私有静态字段）存储唯一实例
• 用 static getInstance() 统一提供访问入口
• 构造器内可加 guard 判断，防止外部 new（非强制，属防御性写法）

兼容性考虑：避免私有字段时的替代写法

若需支持较老环境（如不支持 #private 字段），可用 WeakMap 或普通静态对象模拟私有状态：

• 声明 static instance = null，配合 if (!Singleton.instance) 初始化
• 或用 static _cache = new Map() + Symbol 键隔离，增强封装性
• 注意：单纯赋值 instance 不防篡改，应结合文档约定和运行时校验

支持参数初始化的单例（惰性带参构造）

首次调用 getInstance 时传入参数，之后再调用忽略参数。关键点在于区分“未初始化”和“已初始化”状态：

• 用 static #instance 存实例，static #inited 标记是否完成构造
• getInstance 接收参数，仅在未初始化时执行 new 操作并标记
• 避免多次传不同参数导致行为不一致，建议参数仅用于首次配置

注意事项与常见误区

单例不是全局变量，而是受控的单一实例。需警惕以下问题：

• 模块级单例：ES 模块默认单例（import 多次仍同一对象），有时比手写更简单
• 测试友好性：硬编码单例不利于 mock，可考虑依赖注入或重置方法（如 static reset()）
• 多线程/Worker 场景：JS 单线程下无并发问题，但跨 Worker 不共享实例
• 继承限制：子类调用 super() 时可能绕过单例控制，需在子类中重写 getInstance

不复杂但容易忽略细节。关键是明确“谁负责创建”和“谁负责保管”，把控制权收束到类自身的静态方法中。

终于介绍完啦！小伙伴们，这篇关于《JavaScript单例模式实现详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！