WeakMap 本身不自动避免内存泄漏，关键在于用真实存活对象作键、值不反向引用键、模块级单例管理，并配合类型校验与轻量数据存储。
WeakMap 本身不自动“避免”内存泄漏，它只是提供一种不阻碍垃圾回收的存储机制。真正起作用的是你如何组织数据生命周期——关键在于让缓存条目的存在时间，严格跟随被缓存对象的生命周期。
必须用对象当键，且只用真实、存活的对象
WeakMap 的键只能是对象（如 DOM 元素、类实例），不能是字符串、数字或 null。更重要的是，这个对象得是你真正想绑定缓存生命周期的那个实体。
- DOM 场景：用
element本身作键，不是它的id或 class 名 - 类私有场景：用
this作键，不是随便 new 一个空对象或 Symbol - 务必校验：调用
set()前加if (obj && obj instanceof Node)或obj.constructor === MyClass - 动态插入的节点要等挂载完成后再存，避免传入未就绪或已移除的引用
值的内容必须轻量，且不能反向持有键
WeakMap 只对键是弱引用，值仍是强引用。如果值里保存了对键的引用，就会形成循环，GC 无法释放。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 安全写法：
cache.set(node, { count: 1, status: 'loaded' })—— 纯数据，无引用 - 危险写法：
cache.set(node, { owner: node, handler: () => node.click() })—— 值强引用键，阻断回收 - 避免把
get()返回的对象塞进setInterval、全局变量、未注销的事件监听器里 - 值里别存大型数组、完整组件实例或未清理的定时器句柄
声明在模块顶层，统一单例管理
WeakMap 实例必须是模块级单例，不能在类构造函数、方法或回调里反复新建。
立即学习“Java免费学习笔记（深入）”；
- ✅ 正确：文件顶部
const elementCache = new WeakMap();，所有函数共用 - ❌ 错误：每次
new MyClass()都new WeakMap()，既浪费又失去弱引用意义 - ❌ 错误：在事件处理函数里临时创建 WeakMap，完全无法复用
- 建议封装成带防护的接口，比如
setCache(node, data)内部做类型校验
接受不可遍历、不可统计的特性
WeakMap 没有 size、keys()、values() 或 entries()。这不是缺陷，而是设计使然——防止你无意中重建强引用链。
- 别指望用它做状态统计、批量更新或主动清空逻辑
- 别把它当通用字典替代 Map；需要手动控制生命周期的缓存，该用 Map +
delete - 它适合的场景很明确：数据必须随对象销毁而自动消失，比如 DOM 状态标记、类私有字段、响应式依赖追踪
- 验证是否生效？用 Chrome DevTools Memory 面板拍快照，移除 DOM 后观察 detached 节点是否减少
