weakmap 本身不防止内存泄漏，而是通过弱引用键使数据生命周期与对象一致：需顶层单例声明、键必须为真实对象（如 this 或 dom 元素）、值仍为强引用须避免反向引用，且不可遍历或统计。

WeakMap 本身不会“防止”内存泄漏，它只是提供了一种不阻碍垃圾回收的存储方式。真正起作用的是你如何用它——关键在于让数据生命周期和对象生命周期保持一致。

必须把 WeakMap 声明在模块顶层

WeakMap 实例要作为单例存在，不能在类内部或函数里反复新建：

• ✅ 正确：在文件最外层声明一次，所有实例共享
• ❌ 错误：每次 new 类时都 new WeakMap()，既浪费又失去弱引用意义
• ❌ 错误：在事件回调或工具函数里临时创建 WeakMap，完全无法复用

键必须是真实存在的对象，且只用 Node 或 this

WeakMap 的键必须是对象，而且得是你真正想绑定生命周期的那个对象：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• DOM 场景：用 element 本身当键，不是它的 id 字符串
• 类私有场景：用 this 当键，不是随便造个 symbol 或空对象
• 务必校验：if (node && node instanceof Node) 再 set，避免 null 或非节点传入报错

值的内容也要小心，WeakMap 不管值是否泄漏

WeakMap 只对键是弱引用，值仍是强引用。如果值里存了对键的反向引用，或被长周期闭包持有，照样泄漏：

• 避免在值里写 { owner: this } 这类强引用
• 不要把 WeakMap.get() 返回的对象塞进 setInterval、全局缓存或未注销的事件监听器里
• 值尽量轻量，比如数字、简单对象，别塞整个组件实例或大数组

不用手动清理，但得接受“不可预测”的行为

WeakMap 没有 size、没有 keys()、不能遍历。get() 返回 undefined，不等于没设过，可能是键已被 GC 回收：

• 别依赖 WeakMap 做状态统计或批量操作
• 别用它实现需要主动清空的缓存（该用 Map + 手动 delete）
• 它适合的场景很明确：数据必须随对象销毁而自动消失，比如 DOM 状态、类私有字段、响应式依赖映射

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南