WeakMap 是键必须为对象且弱引用的集合，不阻止垃圾回收，无遍历和 size 方法，适用于 DOM 状态绑定、类私有属性等临时元数据挂载场景，与 Map 互补而非替代。

WeakMap 是 JavaScript 中一种特殊的键值对集合，它的核心作用是让对象作为键时不会阻止垃圾回收，从而避免内存泄漏。

WeakMap 的键必须是对象，且是弱引用

WeakMap 只接受对象（包括函数、数组等）作为键，原始值（如字符串、数字）会直接报错。更重要的是，它对键的引用是“弱引用”——也就是说，如果一个对象只被 WeakMap 引用，而外部没有其他强引用，那么垃圾回收器（GC）可以随时回收这个对象，同时 WeakMap 中对应的键值对也会自动消失。

• Map 对键是强引用：对象被 Map 持有后，即使外部设为 null，也不会被回收
• WeakMap 对键是弱引用：对象一旦失去所有外部引用，GC 就能清理它，无需手动干预
• 这种机制天然适配 JS 的垃圾回收逻辑，不需要开发者额外维护生命周期

它不支持遍历和 size 查询

WeakMap 没有 keys()、values()、entries() 或 size 属性，也不能用 for...of 遍历。这不是缺陷，而是设计使然：防止暴露内部条目，避免干扰 GC 判断，也强化了“临时附着元数据”的语义。

Java 接口排错助手

在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。

下载

• 你只能通过已知对象去 get()、set()、has()、delete()
• 无法枚举意味着无法意外依赖其内容做状态判断，降低了误用风险
• 这也让 WeakMap 更适合做“私有挂载区”，而不是通用存储容器

典型应用场景：DOM 数据绑定与类私有属性

WeakMap 常用于两类高频内存敏感场景：

立即学习“Java免费学习笔记（深入）”；

• 给 DOM 节点附加临时状态：比如记录点击次数、加载状态、表单验证结果。节点被移除后，数据自动释放，不用监听 DOMNodeRemoved 或手动清理
• 模拟类的真正私有字段：把实例作为键，存入闭包外的 WeakMap 中。外部无法访问该 Map，也无法通过反射获取，且实例销毁时数据一并消失
• 第三方库或插件中为任意对象“打标签”或缓存计算结果，又不想影响其生命周期

它不是 Map 的替代品，而是互补工具

WeakMap 不可迭代、不能查大小、不能用原始值作键，这些限制让它不适合做通用映射或长期缓存。它存在的意义不是“更轻量的 Map”，而是解决一类 Map 无法处理的问题：当你要把数据“挂”在某个对象上，又不希望因此延长它的寿命。

• 需要长期持有、可遍历、支持任意键类型 → 用 Map
• 只为某个对象临时附加元数据，且希望随对象一起消失 → 用 WeakMap
• 两者共存不冲突，常配合使用：Map 管主数据流，WeakMap 管附属生命周期