weakmap 通过弱引用 dom 节点防止内存泄漏，节点移除后自动清理；键必须是真实 node 实例，需校验 instanceof node；不替代 map，专用于解耦状态与生命周期；应封装为模块级单例并限制接口。

WeakMap 防止 DOM 节点内存泄漏，核心在于它对键（即 DOM 节点）只做弱引用——节点一旦从 DOM 移除、且没有其他强引用，就会被垃圾回收器立即清理，WeakMap 中对应的条目也自动失效，无需手动 delete。

只用对象作键，且必须是真实存在的 DOM 节点

WeakMap 的键只能是对象，且实际开发中几乎只用于 Node 类型（Element、Document 等）。传入 null、undefined、字符串 ID 或 document.querySelector 返回空结果，都会导致 set 失败或逻辑出错。

• 务必校验：if (node && node instanceof Node) 再调用 weakMap.set(node, data)
• 动态插入的节点可能尚未挂载，getElementById 或 querySelector 返回 null 时直接 set 会抛 TypeError
• 不要把 Window、Array、普通 object 当作键传入，虽不报错，但破坏设计意图

不替代 Map，而是专治“强引用锁死 DOM”

普通 Map 或对象字面量（{}）对键是强引用。哪怕 DOM 节点已调用 remove() 或父元素清空了 innerHTML，只要它还在 Map 里，GC 就认为它“可达”，无法回收——DevTools 中就会看到大量 detached DOM trees。

Alibabacloud Sdk Client Initialization For Java

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

下载

• WeakMap 不计入引用计数，节点失去所有强引用后，立刻可回收
• 你不需要监听 MutationObserver、也不用在节点移除时手动 map.delete()
• 值（value）仍是强引用，所以别存大型对象或组件实例；轻量数据如 { loaded: true, timestamp: 123 } 更安全

典型安全用法：状态管理 + 事件绑定解耦

WeakMap 最自然的落地场景，是给 DOM 元素附加私有状态或缓存上下文，同时确保生命周期完全对齐。

• 为按钮加禁用逻辑：buttonState.set(btn, { disabled: true })，后续通过 btn.isConnected 判断是否还活着，再操作 UI
• 事件监听器复用：用 WeakMap 存一个 Map，记录每个节点绑定了哪些回调，避免重复 addEventListener
• 闭包中不直接捕获 DOM 节点，改用 WeakMap 查找所需数据，切断隐式强引用链

必须是模块级单例，且封装防护接口

多个 WeakMap 实例不仅浪费内存，还会让状态分散、类型失控。生产环境应统一导出一个受控实例。

• 定义一次：const elementData = new WeakMap();
• 暴露带校验的方法：function setElementData(el, data) { if (el instanceof Node) elementData.set(el, data); }
• 禁止直接暴露原始 WeakMap，防止误传非法键或滥用 clear()（WeakMap 本身也没有 clear）

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