WeakMap 是唯一能将数据“悄悄挂载”到对象上且不阻止其被垃圾回收的工具，专治内存泄漏；键必须为对象，因GC只跟踪对象生命周期，原始值会报错。
WeakMap 不是“弱化的 Map”，而是 JavaScript 中唯一能「把数据悄悄挂到对象上，又不拖住它不许销毁」的工具。
它解决的不是功能缺失问题，而是内存泄漏这个静默杀手——尤其在长期运行的单页应用、频繁操作 DOM 的场景里，一个没清理的 Map 就可能让成百上千个已移除的节点永远卡在内存里。
WeakMap 的键为什么必须是对象？原始值会报错
因为弱引用只对对象有效。JavaScript 的垃圾回收器（GC）只管理对象的生命周期，对字符串、数字这些原始值根本不“记账”。WeakMap 的设计前提就是：键得是 GC 能识别、能跟踪、能决定是否回收的东西。
所以一旦你写：
立即学习“Java免费学习笔记（深入）”；
const wm = new WeakMap();
wm.set('hello', 'world'); // TypeError: Invalid value used as weak map key就会立刻报错。这不是限制，是强制你思考：这个键是不是真需要被“弱关联”？如果不是对象，那它本就不该进 WeakMap。
- 合法键类型：
{}、document.getElementById('x')、new Date()、function() {}、[] - 非法键类型：
'str'、42、true、null、undefined
给 DOM 元素存状态，为什么不用 dataset 或属性？
用 element.myState = {...} 看似简单，但污染了元素自身属性，可能和未来标准属性冲突；用 dataset 只支持字符串，还得手动序列化反序列化；而用 Symbol 属性虽私有，仍可被 Object.getOwnPropertySymbols() 枚举出来，测试或调试时暴露无遗。
WeakMap 是真正“不可见”的挂载方式：
const elementState = new WeakMap();
<p>const el = document.querySelector('.card');
elementState.set(el, { expanded: true, lastClick: Date.now() });</p><p>// 页面中移除 el 后，只要没其他变量引用它，el 和对应状态自动消失
el.remove(); // 此后 elementState.has(el) → false（即使 el 变量还存在，但对象已无强引用）关键点：
- 不依赖 DOM 树存在与否，只依赖对象是否还有外部强引用
- 无法通过
for...in、Object.keys()、JSON.stringify()触达，天然防误读 - 没有
size、不能clear()、不可遍历——不是缺陷，是防止你把它当通用容器滥用
模拟类私有字段时，WeakMap 和 # 语法有什么区别？
ES2022+ 支持 #privateField 语法，写起来更简洁。但 WeakMap 仍有不可替代的场景：
- 你需要兼容旧环境（如 IE 或部分 Node.js 版本）
- 你想把私有数据跨多个类共享（比如基类和子类共用一份元数据）
- 你传入的对象不是你创建的（比如用户传来的
HTMLElement或第三方库实例），没法加#字段
示例：为任意对象附加仅内部可用的缓存
const _cache = new WeakMap();
<p>class Renderer {
render(obj) {
if (!_cache.has(obj)) {
_cache.set(obj, this.expensiveTransform(obj));
}
return _cache.get(obj);
}
}这里 obj 可以是任何对象，甚至是你无法修改原型的第三方实例。一旦它被丢弃，缓存条目自动失效，不用 try/catch 或定时清理。
WeakMap 为什么不适合做通用缓存？
因为它不保证键存在——你调用 wm.has(key) 返回 false，未必是没设过，可能是 key 已被 GC 回收了。这导致它无法用于需要稳定命中率的缓存策略（比如 LRU、TTL 控制）。
常见误用：
- 用
WeakMap存 API 响应结果，期望多次请求复用——但若请求参数对象是临时创建的（如{ id: 123 }），每次都是新对象，缓存完全失效 - 依赖
wm.size监控缓存水位——它根本不存在，连 polyfill 都没法可靠实现 - 试图用
JSON.stringify()调试内容——WeakMap不可序列化，会直接忽略
真正适合它的缓存，只有一种：输入对象本身就有稳定生命周期，且你愿意接受“它一走，缓存就空”的语义。比如缓存某个组件实例的布局计算结果，而不是缓存某次 fetch 的响应。
容易被忽略的一点：value 是强引用的。如果你在 WeakMap 里存了一个大数组或闭包，而 key 对象恰好被回收了，value 本身不会自动释放——除非它也只被这个 value 引用。所以别在 value 里偷偷 hold 住别的长生命周期对象，否则照样泄漏。
