JavaScript封装核心是控制访问权限，主要方式有：1.闭包实现真正私有状态；2.ES2025私有字段#field；3.Symbol+WeakMap模拟弱私有；4.模块作用域限制顶层可见性。
JavaScript 实现封装，核心是控制对数据和方法的访问权限，让内部实现细节不被外部随意修改或依赖。虽然 JS 没有原生的 private 关键字（ES2025 才加入私有字段 #field），但有多种成熟、实用的信息隐藏方式。
使用闭包实现真正的私有状态
闭包是最经典、兼容性最好、逻辑最清晰的封装手段。函数内部定义的变量，外部无法直接访问，只能通过返回的函数间接操作。
- 变量定义在函数作用域内，外部无法读写
- 返回的对象方法保留对这些变量的引用，形成“特权方法”
- 适合需要强隔离的数据（如计数器、配置缓存、连接状态）
例如：
function createCounter() {
let count = 0; // 完全私有，外部不可见
return {
increment() { count++; },
getValue() { return count; }
};
}
const counter = createCounter();
counter.increment();
console.log(counter.getValue()); // 1
// console.log(counter.count); // undefined —— 真正隐藏
使用 ES2025 私有字段（#name）
现代标准中，类内可用井号前缀声明真正私有的实例字段和方法，仅类内部可访问，语法简洁且由引擎强制保护。
- 必须用
#开头，且只能在 class 内部定义和使用 - 不能在外部读取、修改，也不能用
in、for...in或反射检测 - 支持私有 getter/setter 和私有方法
例如：
class BankAccount {
#balance = 0;
#pin = '1234
';
deposit(amount) {
if (amount > 0) this.#balance += amount;
}
validatePin(input) {
return input === this.#pin;
}
withdraw(amount, pin) {
if (this.#validatePin(pin)) {
if (amount
';
使用 Symbol 作为属性键模拟弱私有
利用 Symbol 的唯一性和不可枚举性，把敏感属性挂到对象上，避免被常规遍历发现，但不防主动访问（属于“约定式隐藏”）。
- 外部仍可通过
Object.getOwnPropertySymbols()获取，安全性低于闭包或 # 字段 - 适合框架内部标记、避免命名冲突，或需序列化时排除某些字段
- 常配合
WeakMap实现更安全的私有存储
例如（配合 WeakMap）：
const _cache = new WeakMap();class ExpensiveProcessor { constructor(data) { _cache.set(this, { result: null, lastUpdated: 0 }); this.data = data; }
getResult() { const priv = _cache.get(this); if (!priv.result) { priv.result = this.#compute(); priv.lastUpdated = Date.now(); } return priv.result; }
compute() { / heavy logic / }
}
使用模块作用域限制顶层可见性
ES 模块天然具备作用域封装能力：模块顶部声明的变量、函数默认对外不可见，只暴露 export 的内容。
- 模块内函数可自由调用彼此，但未导出的不会污染全局或被其他模块直接使用
- 适合组织工具函数、单例服务、配置管理等
- 是构建大型应用时最常用、最自然的封装层级
例如（apiClient.js）：
// 内部私有工具，不被外部访问
function buildUrl(path) { return `/api${path}`; }
const DEFAULT_TIMEOUT = 5000;
// 只导出需要的接口
export async function fetchUser(id) {
const url = buildUrl(/users/${id});
return fetch(url, { timeout: DEFAULT_TIMEOUT });
}
基本上就这些。闭包最通用，私有字段最规范，Symbol + WeakMap 适合高级模式，模块作用域则是日常开发的基础防线。选哪种，看目标环境、团队规范和封装强度需求。
