WeakMap 是实现类实例私有数据的理想工具，因其键为弱引用对象、不可遍历、不参与属性反射，可避免内存泄漏且兼容老环境。
在 JavaScript 中，WeakMap 是实现类实例私有数据的理想工具——它既能避免内存泄漏，又能让私有属性真正“不可枚举、不可遍历、不可反射”，比闭包或 Symbol 更轻量、比 # 私有字段更兼容老环境。
为什么 WeakMap 适合存私有数据
WeakMap 的键必须是对象，且对键是弱引用：当某个类实例被销毁时，只要没有其他强引用指向它，WeakMap 中对应的条目会自动被垃圾回收。这解决了闭包导致的内存泄漏风险，也比用普通 Map 更安全。
同时，WeakMap 本身不可遍历，外部无法通过 keys()、values() 或 for...of 获取所有键值对；也无法通过 Object.getOwnPropertyNames 或 Reflect.ownKeys 访问到这些私有字段——它们完全游离于实例自身的属性系统之外。
基本用法：为每个实例绑定私有状态
典型模式是在类外部声明一个 WeakMap，然后在构造函数中用 this 作为键存入数据：
立即学习“Java免费学习笔记（深入）”；
const privateData = new WeakMap();
<p>class Person {
constructor(name) {
// 存储私有字段
privateData.set(this, { name, _id: Math.random() });</p><pre class='brush:php;toolbar:false;'>// 公共方法可读写私有数据
this.getName = () => privateData.get(this).name;
this.setId = (id) => { privateData.get(this)._id = id; };} }
注意：不要在类内部（如 constructor 中）直接 new WeakMap()，否则每个实例都会持有一个独立 WeakMap，失去共享与弱引用的意义。
进阶技巧：封装访问器与类型安全
为避免每次手动 get(this)，可以封装一个辅助函数或使用 getter/setter 隐藏细节：
- 用静态方法统一管理，增强可维护性
- 配合 TypeScript 接口定义私有结构，提升开发体验
- 在 getter 中做存在性检查，防止未初始化时报错
const privates = new WeakMap();
<p>class Counter {
constructor(initial = 0) {
privates.set(this, { value: initial });
}</p><p>get value() {
return privates.get(this)?.value ?? 0;
}</p><p>set value(v) {
const data = privates.get(this);
if (data) data.value = v;
}</p><p>increment() {
this.value += 1;
}
}</p>注意事项与常见误区
- WeakMap 实例不能作为原型方法的 this 替代品：不能用 WeakMap 模拟“私有方法”，因为方法必须挂在实例或原型上才能被调用
- 无法序列化：JSON.stringify 会忽略 WeakMap 数据，服务端或持久化场景需额外处理
- 不支持扩展运算符和解构：{...instance} 不会包含 WeakMap 中的数据
- 调试困难：开发者工具通常不显示 WeakMap 内容，建议搭配 console.log(privateData.get(instance)) 辅助排查
WeakMap 不是万能的私有方案，但在需要兼容性、控制内存、且不依赖语法级私有特性的场景下，它依然是最实用的选择之一。
