WeakMap与Map区别详解：JavaScript内存管理核心概念

WeakMap 是 JavaScript 中一种特殊的键值集合，其核心特性在于键必须为对象且不阻止垃圾回收，这意味着它能安全地为对象附加私有元数据（如 DOM 元素配置或类实例状态），在对象被销毁时自动清理对应条目，彻底避免内存泄漏；但它刻意舍弃了遍历、size、clear 等能力，也不支持原始值作为键，因此绝非 Map 的轻量替代品，而是一个专为“依附式、临时性、不可枚举”场景设计的精密工具——理解它与 Map 的本质差异，是写出健壮、无泄漏前端代码的关键一步。

WeakMap 的键只能是对象，原始值会直接报错

如果你尝试用字符串、数字或布尔值作为 WeakMap 的键，JavaScript 会立刻抛出 TypeError: Invalid value used as weak map key。这不是运行时隐式转换，而是硬性限制。

原因在于：弱引用机制依赖于对象在内存中的身份（即引用地址），而原始值没有“引用”概念，它们按值传递、不可被 GC 追踪。

• const wm = new WeakMap();
• wm.set({}, 'ok'); // ✅ 正常
• wm.set([], 'array'); // ✅ 数组也是对象
• wm.set(function(){}, 'fn'); // ✅ 函数也是对象
• wm.set('str', 'bad'); // ❌ 报错
• wm.set(42, 'bad'); // ❌ 报错

WeakMap 不阻止垃圾回收，Map 会锁住对象不释放

这是两者最本质的差异，直接影响内存行为。当你把一个对象存进 Map，它就「被记住了」——哪怕你把原变量设为 null，只要 Map 还活着，这个对象就一直占着内存；而 WeakMap 不会干涉 GC，对象一旦失去所有其他引用，就会被回收，对应条目也自动消失。

const map = new Map();
const wm = new WeakMap();
<p>let obj = { id: 1 };
map.set(obj, 'from map');
wm.set(obj, 'from weakmap');</p><p>obj = null; // 切断外部引用</p><p>// 此时：
// - map 中仍能查到该对象（强引用锁住）
// - wm 中已无法访问（obj 被 GC 后条目自动清理）
// 注意：GC 时机不可控，但行为确定 —— 你不需手动 delete</p>

常见踩坑：误以为 WeakMap 是“轻量版 Map”，结果在需要长期持有数据的场景（比如全局缓存）用了它，导致数据莫名消失。

WeakMap 不支持遍历、size 和 clear，也没 get 方法

WeakMap 没有 keys()、values()、entries()、forEach()，也没有 size 属性，甚至没有 get() 方法（等等，它其实有 —— 但文档里写的是有，实际 API 是存在的；不过重点是它不支持任何枚举手段）。

• 不能用 for...of 遍历
• 不能通过 wm.size 查数量（返回 undefined）
• 不能调用 wm.clear()（该方法不存在）
• 不能初始化时传数组：new WeakMap([[{}, 'val']]) 会报错

这些限制不是疏漏，而是设计选择：确保附加在对象上的元数据真正“私有”——外部代码无法探测、枚举或批量操作。

典型用途：给 DOM 元素或类实例加私有状态，不干扰生命周期

最常见的安全用法，就是把临时、附属性的数据和某个对象绑定，又不想让它阻碍回收。比如：

• 为第三方 DOM 元素添加自定义配置，页面卸载后自动清理
• 在类中模拟私有字段（ES6 class 不支持真正的私有属性时）
• 实现基于对象身份的缓存（如 computeExpensive(obj) 结果只对这个 obj 有效）

const elementCache = new WeakMap();
<p>function getCachedData(el) {
if (!elementCache.has(el)) {
elementCache.set(el, expensiveParse(el));
}
return elementCache.get(el);
}</p><p>// el 移除后，elementCache 自动丢弃对应条目，无泄漏</p>

注意：别指望用 WeakMap 做通用缓存或配置中心 —— 它的不可遍历性和弱引用特性，决定了它只适合“依附于对象存在”的场景。一旦你需要主动管理、统计或调试内容，Map 才是正解。

到这里，我们也就讲完了《WeakMap与Map区别详解：JavaScript内存管理核心概念》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！