WeakMap是什么？与Map区别全解析

WeakMap 是 JavaScript 中一种特殊的键值集合，其核心特性在于键必须是对象且不阻止垃圾回收，这使它成为为对象安全附加私有元数据的理想工具；与 Map 的强引用、可遍历、可管理不同，WeakMap 无法使用 size、clear、forEach 等方法，也不支持原始值作为键，这种“不可见、不可枚举、不干扰生命周期”的设计，让它在 DOM 元素缓存、类实例私有状态模拟等场景中既高效又内存友好——但若你需要长期持有、批量操作或调试数据，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();
let obj = { id: 1 };
map.set(obj, 'from map');
wm.set(obj, 'from weakmap');
obj = null; // 切断外部引用
// 此时：
// - map 中仍能查到该对象（强引用锁住）
// - wm 中已无法访问（obj 被 GC 后条目自动清理）
// 注意：GC 时机不可控，但行为确定 —— 你不需手动 delete

常见踩坑：误以为 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();
function getCachedData(el) {
if (!elementCache.has(el)) {
elementCache.set(el, expensiveParse(el));
}
return elementCache.get(el);
}
// el 移除后，elementCache 自动丢弃对应条目，无泄漏

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

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。