WeakMap 是唯一能安全为 DOM 节点附加元数据且防内存泄漏的原生方案，因其键为弱引用，节点移除后自动清理；需校验节点类型、用单例实例、防护读写，并注意值的强引用风险。
WeakMap 是 JavaScript 中唯一能安全为 DOM 节点附加元数据且不引发内存泄漏的原生方案。它的核心价值在于：键是弱引用，节点一旦从 DOM 移除且无其他强引用，对应条目自动消失，无需手动清理。
为什么必须用 WeakMap 而不是普通对象或 Map
直接挂载属性（如 node.data = {...}）会污染节点，还形成强引用；用 Map 存储则会让已移除的节点长期滞留内存——DevTools 里能看到大量 detached DOM trees，performance.memory.usedJSHeapSize 持续上涨。WeakMap 不计入 GC 引用计数，只“标记”节点，不“留住”它。
正确写法：校验 + 设置 + 使用
不能跳过存在性和类型检查。常见错误是把 null、字符串 ID 或未查到的元素传给 set()，直接抛 TypeError。
- 先确认节点真实存在且是 Node 实例：if (node && node instanceof Node)
- 用单例 WeakMap 实例，避免多个实例导致状态分散：const elementMeta = new WeakMap()
- 设置时带防护：elementMeta.set(node, { clicked: 0, lastActive: Date.now() })
- 读取前用 has() 判断更稳妥：if (elementMeta.has(node)) { const meta = elementMeta.get(node) }
值（data）也要注意生命周期
WeakMap 只保证键的弱引用，值仍是强引用。如果值里包含定时器回调、未解绑的事件闭包，或被全局变量长期持有，照样造成泄漏。
立即学习“Java免费学习笔记（深入）”；
- 避免在元数据中存大型对象或闭包，优先用轻量结构（如 plain object、number、string）
- 若需函数，确保它不意外捕获外部大对象；必要时在节点移除后主动清空相关句柄
- 值本身不自动释放——WeakMap 不管它，只管键是否还活着
典型封装建议
导出一个带防护的模块接口，统一约束使用方式：
- export const nodeData = new WeakMap()
- export function setNodeMeta(node, data) { if (node instanceof Node) nodeData.set(node, data) }
- export function getNodeMeta(node) { return node instanceof Node ? nodeData.get(node) : undefined }
这样既防误用，又便于后续加日志、类型断言或调试钩子。
