WeakMap 是唯一不阻止垃圾回收的键值结构，专为元数据绑定设计；键必须是对象且为弱引用，无 size、遍历、清空等方法，无法序列化或调试。
WeakMap 是 JavaScript 中唯一能“附着数据却不拖住对象”的键值结构——它不阻止垃圾回收，专为元数据绑定而生。
为什么不能用普通 Map 存 DOM 元信息？
当你用 Map 给 DOM 节点存状态时，哪怕节点已被 remove()、页面也跳转了，只要它还在 Map 里，引擎就认为“还有引用”，无法回收。结果就是内存悄悄涨上去，DevTools 里看到大量 detached DOM 节点残留。
而 WeakMap 的键是弱引用：只要节点在 JS 代码里没其他变量指向它，GC 就能立刻收走，WeakMap 里对应的条目也自动消失。
- ✅ 正确做法：
const nodeMeta = new WeakMap();<br>const el = document.getElementById('app');<br>nodeMeta.set(el, { lastClick: Date.now(), isExpanded: true });<br>// el 被 remove() 后，nodeMeta 中该条目不可访问，也不占内存 - ❌ 错误做法：
const map = new Map(); map.set(el, ...)—— 节点变“永生” - ⚠️ 注意：
WeakMap的键必须是对象，nodeMeta.set('div#app', ...)会直接报TypeError: Invalid value used as weak map key
怎么用 WeakMap 模拟类的私有属性？
ES2022 才有真正私有字段（#field），但很多老项目或需兼容旧环境时，WeakMap 是最稳妥的替代方案：外部无法访问，且实例销毁时数据自动清空。
立即学习“Java免费学习笔记（深入）”；
- 把
WeakMap实例定义在模块顶层（非 class 内），避免暴露 - 用
this作为键，值存私有数据对象 - 所有方法通过闭包访问该
WeakMap，不暴露原始数据
const _privateData = new WeakMap();<br><br>class Person {<br> constructor(name) {<br> _privateData.set(this, { name, createdAt: Date.now() });<br> }<br> getName() {<br> return _privateData.get(this)?.name;<br> }<br>}<br><br>const p = new Person('Alice');<br>console.log(p.getName()); // 'Alice'<br>// p = null; → GC 后，_privateData 中对应项自动失效
WeakMap 有哪些硬性限制？踩坑前必须知道
它的设计哲学就是“不让你控制它”——不是缺陷，而是防止你误用弱引用语义。
- 没有
size属性，不能调用keys()、values()、entries()或forEach() - 无法遍历、无法清空（没有
clear()）、无法检测某个键是否还存在（has()只能告诉你“当前存在”，但下一秒可能就被 GC 掉） - 调试困难：DevTools 里看不到内容，
console.log(weakMap)只显示WeakMap {} - 不能序列化：
JSON.stringify(weakMap)得到空对象{}，别指望存到 localStorage
WeakMap 不是 Map 的“轻量版”，它是另一种契约：你提供对象，它帮你守好边界——不插手生命周期，也不给你反向控制权。真要用它，就得接受“写进去，忘掉它；对象活着，它就在；对象没了，它也没了”这个事实。
