Weakmap 的键只能是对象，原始值会报错；它不阻止垃圾回收，而 Map 会强引用锁住对象；WeakMap 不支持遍历、size、clear 等操作，适用于为对象附加私有元数据。
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; // 切断外部引用
立即学习“Java免费学习笔记（深入）”；
// 此时： // - 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 才是正解。