WeakMap 和 WeakSet 是专为对象生命周期管理设计的弱引用集合,用于安全关联对象信息且不阻碍垃圾回收,不可遍历、无 size,仅适用于隐形元数据容器场景。

WeakMap 和 WeakSet 是什么?它们不是“升级版”,而是“专用工具”
WeakMap 和 WeakSet 是 JavaScript 中专为对象生命周期管理设计的弱引用集合,核心目的只有一个:让你能安全地关联对象信息,又不阻碍垃圾回收。它们不是 Map/Set 的替代品,更不是性能优化手段——用错场景反而会让代码更难调试。
为什么 WeakMap/set 会“自动消失”?关键在弱引用和 GC 行为
普通 Map 或 Set 会对键或值保持强引用,只要它还在集合里,对象就永远不会被回收;而 WeakMap 只接受对象作键、WeakSet 只接受对象作元素,且这些对象是弱引用——也就是说,一旦外部所有变量都断开对该对象的引用(比如 obj = null),GC 就可能随时把它连同对应条目一起清理掉。
- 你无法预测它何时消失,也无法主动触发“已清理”通知
-
weakMap.has(obj)在 GC 后可能突然返回false,哪怕你刚调用过get() - 没有
size、不能for...of、没有keys()/values()——因为内容本身是动态不确定的
哪些地方必须用 WeakMap/WeakSet?典型场景与错误写法
它们只适合做“隐形元数据容器”,不适合存业务主数据。
-
WeakMap 正确用法:模拟私有属性、缓存计算结果、绑定 DOM 节点元信息
const privateData = new WeakMap(); class User { constructor(name) { this.name = name; privateData.set(this, { createdAt: Date.now() }); } getCreatedAt() { return privateData.get(this)?.createdAt; } } -
WeakSet 正确用法:标记“正在处理中”的 DOM 节点,节点被移除后标记自动失效
const processingNodes = new WeakSet(); function startProcessing(node) { if (!processingNodes.has(node)) { processingNodes.add(node); // ... do work } } // node.remove() 后,processingNodes.has(node) 很快返回 false -
常见错误:
- 试图用字符串当
WeakMap的键 → 报错:TypeError: Invalid value used as weak map key - 想遍历
WeakSet或检查它的长度 → 没有size、没有迭代器,只能靠has()单点验证 - 把
WeakMap当成通用缓存,却没意识到键对象一丢,缓存就没了
- 试图用字符串当
Map/Set 和 WeakMap/WeakSet 怎么选?看这三点就够了
别纠结语法,直接问自己三个问题:
立即学习“Java免费学习笔记(深入)”;
- 你要存的键/值是否全是对象?不是 → 只能选
Map/Set - 你是否需要遍历、统计、清空整个集合?需要 → 只能选
Map/Set - 你是否在避免内存泄漏,尤其是长期持有 DOM 节点、事件监听器或组件实例?是 →
WeakMap/WeakSet才是解药
WeakMap 和 WeakSet 的“不可靠性”恰恰是它们最可靠的地方——只要你没把它当成常规容器用,它就不会出问题。但一旦你指望它稳定存在,就等于在和 GC 赌运气。










