WeakMap 的键是弱引用对象,不阻止垃圾回收,值可任意类型;仅支持对象作键,无迭代方法和 size 属性;适用于绑定元数据、缓存、私有字段等场景,但不解决值引用或外部强引用导致的内存泄漏。

WeakMap 的键是弱引用的,这意味着只要对象没有其他强引用,即使它作为 WeakMap 的键存在,垃圾回收器也能正常回收该对象。 这是 WeakMap 与普通 Map 的核心区别,也是它被设计用来解决内存泄漏问题的关键机制。
WeakMap 的键只能是对象,且不阻止垃圾回收
WeakMap 要求所有键必须是对象(包括函数、数组、普通对象等),不能是原始值(如字符串、数字、Symbol)。更重要的是,WeakMap 对这些键对象的引用是“弱”的——它不会计入 JavaScript 引擎的可达性判断中。也就是说:
- 如果一个对象只被 WeakMap 键引用,而其他地方(变量、属性、闭包等)都不再持有对该对象的引用,那么该对象在下一次垃圾回收时就会被释放;
- 一旦对象被回收,WeakMap 中对应的键值对会自动消失(你无法遍历或探测到它是否还存在);
- WeakMap 不暴露 keys()、values()、entries() 等迭代方法,也无法获取其大小(没有 size 属性),正是为了配合这种不可观测的弱引用行为。
典型使用场景:为对象附加私有元数据
WeakMap 常用于在不修改原对象的前提下,为其关联一些临时、生命周期一致的附加信息。例如:
- 缓存计算结果(如 DOM 元素的布局尺寸),当元素被移除后,缓存自动失效;
- 实现私有实例字段(ES2022 之前常用模式),避免属性名冲突或被外部访问;
- 跟踪对象状态(如是否已初始化、是否正在处理中),且不干扰对象的生命周期。
因为这些元数据的生命周期天然应与目标对象一致,WeakMap 正好提供了一种“绑定但不延长寿命”的方式。
立即学习“Java免费学习笔记(深入)”;
WeakMap 不等于“自动清理一切”,需注意常见误区
WeakMap 的弱引用仅作用于键,对值没有任何限制或特殊处理:
- 值可以是任意类型(包括对象),若值是对象且被 WeakMap 持有,它仍可能因这个引用而保持存活(除非该值本身也只被 WeakMap 引用);
- WeakMap 本身不会主动触发 GC,它只是“不阻碍”GC——是否回收取决于引擎的垃圾回收策略和当前内存压力;
- 不能用 WeakMap 替代手动清理逻辑。例如,监听器未解绑、定时器未清除、闭包意外保留引用等,仍会导致内存泄漏,WeakMap 无法补救。
简单验证:观察对象是否被回收
虽然无法直接检测对象是否已被 GC,但可通过以下方式间接验证 WeakMap 的弱引用特性:
- 创建一个对象,设为 WeakMap 的键,并保存一个值;
- 将该对象变量置为 null 或脱离作用域;
- 调用 globalThis.gc()(仅 Node.js 启用 --expose-gc 时可用)触发 GC;
- 之后调用 weakMap.has(obj) 会返回 false(因为 obj 已不可达,内部键已失效)。
浏览器环境无法强制 GC,但可通过反复创建/丢弃大量对象并监控内存占用,观察是否出现稳定增长(无 WeakMap) vs 平稳回落(有 WeakMap)来佐证效果。










