WeakMap 能提升封装安全性，因其键必须是对象、弱引用、不可枚举且无法遍历，外部无法访问或遍历私有数据，实例销毁后自动回收，不同实例间完全隔离；推荐在模块顶层声明 WeakMap 并于构造函数中一次性初始化私有对象。
WeakMap 是 ES6 提供的原生集合类型，它天然适合作为“私有变量存储容器”，核心在于键必须是对象、弱引用、不可枚举、无法遍历。它不提供语法级私有（如 # 字段），但能实现运行时真正隔离的封装效果，尤其适合类实例或 DOM 元素绑定的私有状态。
为什么 WeakMap 能提升封装安全性
普通对象属性、Symbol 属性甚至 # 字段都有局限：
- 对象属性名可被
for...in、Object.keys()枚举，也能被delete或意外覆盖 - Symbol 属于“约定私有”，仍可通过
Object.getOwnPropertySymbols()拿到，且无法阻止 JSON 序列化暴露 - # 字段语法简洁，但 IE 完全不支持，旧版 Node.js（≤12）和 Safari（≤14.1）也缺失
- WeakMap 的键只能是对象，外部代码既不能遍历它，也无法通过实例反向查出私有数据结构
标准写法：模块顶层声明 + 构造函数初始化
关键不是“用了 WeakMap”，而是它的作用域和使用时机。必须把 WeakMap 声明在类外部（模块顶层），并在构造函数中仅初始化一次：
const privateData = new WeakMap();
<p>class User {
constructor(name, email) {
// 每个实例独享一份私有数据对象
privateData.set(this, {
name,
email,
lastLogin: Date.now(),
_token: crypto.randomUUID() // 真正不想暴露的字段
});
}</p><p>getName() {
return privateData.get(this)?.name;
}</p><p>login() {
const data = privateData.get(this);
data.lastLogin = Date.now();
}
}这样做的好处：privateData 不可被外部访问；实例销毁后对应条目自动回收；不同实例间完全隔离。
立即学习“Java免费学习笔记（深入）”；
多字段管理：统一存对象，别建多个 WeakMap
需要管理 count、createdAt、isRunning 等多个私有字段时，不要为每个字段单独定义一个 WeakMap。统一用一个对象组织更清晰、性能更好：
- ✅ 推荐：只用一个 WeakMap，value 是完整私有对象
- ❌ 避免：为
count、isRunning各建一个 WeakMap —— 增加内存开销，逻辑分散 - ❌ 错误：在方法里反复调用
privateData.set(this, {...})—— 会覆盖原有状态
常见陷阱与规避方式
WeakMap 很好用，但容易因写法不当破坏封装或引发内存问题：
- 别用 Map 替代 WeakMap：Map 强引用 key，实例销毁后私有数据仍驻留内存，造成泄漏
-
别在方法内新建 WeakMap：比如在
increment()里写new WeakMap()—— 完全失去复用和弱引用意义 -
键必须是对象：传字符串、数字或
null会直接报错TypeError: Invalid value used as weak map key -
避免值中强引用 this：如果私有对象里存了
{ owner: this }，可能间接阻止 GC，削弱 WeakMap 优势
