WeakMap 能安全封装私有变量，因其键必须为对象且是弱引用，对象销毁时私有数据自动释放；不可遍历、无反射接口，从机制上隔绝外部访问。
WeakMap 是 JavaScript 中实现真正私有变量封装的可靠方式，它利用对象作为键、只允许对象类型键、且不阻止垃圾回收的特性，让私有数据与实例强绑定又不造成内存泄漏。
为什么 WeakMap 能安全封装私有变量
WeakMap 的键必须是对象（不能是字符串或数字），且对键的引用是“弱引用”——当该对象没有其他强引用时，WeakMap 中对应的条目会自动被清除。这天然契合实例私有数据的生命周期：对象销毁，私有数据也随之释放，不会意外滞留。
同时，WeakMap 本身不可遍历，外部无法通过 keys()、values() 或 for...of 访问其内容，也没有类似 Object.getOwnPropertyNames() 的反射手段能探测到它存储的数据，从语言机制上隔绝了外部窥探。
基础封装模式：构造函数 + WeakMap
将 WeakMap 实例定义在模块作用域（如 IIFE 或 ES 模块顶层），用它映射实例对象到私有数据对象：
立即学习“Java免费学习笔记（深入）”；
- 每个实例对象作为 WeakMap 的 key
- 对应 value 是一个普通对象，存放所有私有字段（如 _name、_id）
- 公有方法通过 this 查找 WeakMap 中的私有数据，完成读写
示例：
const privateData = new WeakMap();
class Person {
constructor(name, age) {
// 将私有数据绑定到当前实例
privateData.set(this, { _name: name, _age: age });
}
getName() {
return privateData.get(this)._name;
}
setName(name) {
privateData.get(this)._name = name;
}
getAge() {
return privateData.get(this)._age;
}
}
配合闭包增强封装性（推荐进阶用法）
把 WeakMap 和访问器函数一起封在闭包里，彻底隐藏 WeakMap 变量名，避免被外部同名变量污染或误操作：
- WeakMap 不再暴露为模块级变量，仅在闭包内可访问
- 所有 getter/setter 都闭包内定义，确保私有数据路径唯一可控
- 适合构建多个类或需要严格隔离的私有状态场景
示例：
const createPersonClass = () => {
const privateData = new WeakMap();
return class Person {
constructor(name, age) {
privateData.set(this, { _name: name, _age: age });
}
getName() { return privateData.get(this)._name; }
setName(v) { privateData.get(this)._name = v; }
getAge() { return privateData.get(this)._age; }
};
};
const Person = createPersonClass();
注意事项和常见误区
- 不能用原始值作 key：WeakMap 只接受对象。试图传入 'id1' 或 42 会抛错
- 无法序列化：JSON.stringify() 忽略 WeakMap 字段，私有数据天然不参与序列化，符合预期
- 不适用于静态私有变量：WeakMap 绑定的是实例，静态私有需用单独的 Symbol 或闭包变量
- 调试困难：开发者工具中看不到 WeakMap 内容，需靠 console.log(this) + 断点配合 privateData.get(this) 查看
不复杂但容易忽略。
