weakmap 和 weakset 的核心作用是让关联数据随对象自动回收,避免内存泄漏;weakmap 以对象为键存私有状态,weakset 用于轻量级对象状态标记,二者均不阻止垃圾回收。

WeakMap 和 WeakSet 的核心作用,是让关联数据“跟着对象一起走”——对象没了,数据自动消失,不用手动清理,从而避开因强引用导致的内存泄漏。
用 WeakMap 存对象私有状态,不干扰回收
当你需要为某个对象(比如 DOM 元素、类实例)附加额外信息,又不想延长它的生命周期时,WeakMap 是最自然的选择。它只弱引用键对象,只要该对象在其他地方失去所有强引用,整个键值对就会被自动清理。
- 键必须是对象,不能是字符串或数字;值可以是任意类型,但值本身仍是强引用(注意别在值里反向引用键,否则会形成循环,阻碍回收)
- 适合场景:DOM 元素绑定元数据、函数结果缓存(以参数对象为键)、模拟类的私有字段
- 示例:给按钮实例加隐藏配置,实例被置为 null 后,配置条目随之消失,无需 delete
用 WeakSet 标记对象状态,避免重复处理
WeakSet 不存“值”,只回答“这个对象是否在里面”。它只弱引用所存的对象,对象一旦被回收,WeakSet 中对应项也自动失效,特别适合做轻量级状态标记。
- 不能遍历、没有 size、无法 clear,正是为了不产生额外强引用
- 适合场景:记录已初始化的 DOM 节点、跳过已处理的事件目标、防止递归遍历时重复访问同一对象
- 示例:调用 initNode(node) 前先查 WeakSet.has(node),节点被移除后,标记自动清理
避开几个关键误区
WeakMap 和 WeakSet 不是通用容器,误用反而掩盖问题:
- 不要指望立即清除——垃圾回收时机不可控,条目可能短暂残留
- WeakMap 的值不是弱引用:如果值中持有对键的引用(比如闭包、嵌套对象),会阻止键对象回收
- 调试困难:控制台显示为空或 WeaMap{},只能靠 has()/get() 判断,无法 console.log 全量内容
- 不适用于字符串、数字等基本类型,也不能替代 Map/Set 做通用集合或持久缓存
搭配使用效果更稳
单独用 WeakMap 或 WeakSet 已能解决多数引用型泄漏,但配合其他机制可更可靠:
- 与 Proxy 结合,可实现带弱引用监听的对象包装
- 与 FinalizationRegistry 配合,能在对象被回收时触发清理逻辑(如释放底层资源)
- 在 React 等框架中,用 WeakMap 缓存组件序列化结果、用 WeakSet 跟踪活跃 Fiber 节点,卸载即清,无残留










