WeakMap适合存私有属性，因其键必须是对象且为弱引用，对象无其他引用时GC可自动回收，避免内存泄漏；常用于类实例的缓存、状态标记等，需将WeakMap声明在模块顶层共享，而非每次实例化新建。
WeakMap 为什么适合存私有属性
因为 WeakMap 的键必须是对象，且对键是弱引用——只要对象没被其他地方引用，哪怕它还在 WeakMap 里，GC 也能回收它。这天然规避了用普通 Map 或对象字面量做私有存储时常见的内存泄漏：比如把 DOM 元素当 key 存进 Map，但元素已被移除却忘了手动 delete，就一直占着内存。
实际场景中，你常会想给某个类实例“挂”些不希望被外部访问、也不希望阻碍 GC 的数据，比如缓存计算结果、内部状态标记、或绑定的事件回调引用。WeakMap 正是干这个的。
典型写法：在构造函数里绑定 WeakMap 实例
关键点不是「用 WeakMap」，而是「怎么组织它的生命周期」。最稳妥的做法是把 WeakMap 声明在模块顶层（或类外部作用域），而不是每次 new 实例都新建一个：
const privateStore = new WeakMap();
<p>class Counter {
constructor() {
// 每个实例都作为 key，存自己的私有数据
privateStore.set(this, { count: 0, createdAt: Date.now() });
}</p><p>increment() {
const priv = privateStore.get(this);
priv.count++;
}</p><p>getCount() {
return privateStore.get(this)?.count ?? 0;
}
}这样写有几个好处：
-
privateStore是单例，所有实例共享同一张表，不会重复创建结构 - 实例被销毁后，
privateStore里对应的条目自动失效，无需手动清理 - 外部代码无法访问
privateStore，也就拿不到私有字段
容易踩的坑：闭包捕获 this 或误用字符串 key
常见错误是把 WeakMap 写在方法里，或者试图用非对象当 key：
- ❌ 在实例方法中新建
WeakMap：new WeakMap()放在increment里 —— 每次调用都新建，完全失去复用和弱引用意义 - ❌ 用字符串当 key：
privateStore.set('some-id', value)—— WeakMap 会直接报错TypeError: Invalid value used as weak map key - ❌ 用箭头函数绑定了
this，但又在别处保留了对函数的引用（比如传给addEventListener），导致实例无法被 GC —— 这不是 WeakMap 的问题，但 WeakMap 不会帮你解决这种间接引用泄漏
WeakMap 只管「键是否还活着」，不管「值里有没有反向引用」。如果私有数据里存了对当前实例的强引用（比如 { owner: this }），那还是可能泄漏。
和 # 私有字段语法（#field）比有什么区别
ES2022 的 #count 语法更简洁、更安全，但 WeakMap 方案仍有不可替代的场景：
- 需要动态键名（比如根据传入参数生成不同私有字段名）
- 需要在多个不相关的类之间共享同一份私有存储逻辑（比如统一的调试元数据注入）
- 目标环境不支持私有字段（如某些 Node.js 旧版本、IE 完全不支持）
- 想在运行时检查/遍历私有状态（WeakMap 可以通过保存所有实例引用做到，
#字段完全不可见）
不过要注意：WeakMap 本身不提供访问控制，只要拿到那个 WeakMap 实例，就能读写任意对象的私有数据。所以一定要确保 privateStore 不被导出、不挂到全局、不被意外暴露 —— 它的“私有性”靠的是模块封装，不是语言机制。
