JavaScript私有字段（#）由引擎强制执行封装，必须在类顶层声明且不可动态添加，仅限声明类的词法作用域内访问，对反射/序列化API完全隐身，并需配合ESM模块导出控制实现真正封装。
JavaScript 中私有字段（以 # 开头）的定义和访问不是靠约定或工具约束，而是由引擎在语法和运行时强制执行的硬性边界——它划出了一条清晰、不可绕过的封装线。
定义必须在类体顶层显式声明
私有字段不能动态添加，也不能延迟初始化。必须在 class 块内部直接声明，支持初始化表达式，但不允许条件式赋值或构造函数外补写：
- ✅ 正确：
class A { #id = Symbol(); #count = 0; constructor() { this.#name = "test"; } } - ❌ 错误：
const a = new A(); a.#flag = true;（语法错误，直接拒绝解析） - ⚠️ 危险：
constructor(x) { if (x) this.#opt = x; }（可能未定义就访问，调用 getter 时抛 TypeError）
访问仅限于声明类的词法作用域内
私有字段的“可见性”完全绑定到类定义本身，而非实例、原型或继承链。哪怕两个对象是同一类的实例，彼此也无法互相访问对方的 # 字段：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- ✅ 允许：实例方法中用
this.#value读写 - ❌ 禁止：另一同类型实例
other.#value（SyntaxError） - ❌ 禁止：子类中尝试
this.#parentField或super.#parentField（无继承、无 super 支持） - ❌ 禁止：静态方法中访问实例私有字段（
static foo() { return this.#x; }报错，this 指向类而非实例）
对所有反射与序列化 API 完全隐身
私有字段不挂载在对象的公开属性空间中，因此不会被任何标准机制探测或导出：
立即学习“Java免费学习笔记（深入）”；
-
Object.keys(obj)、for...in、JSON.stringify(obj)均不包含 # 字段 -
Reflect.ownKeys(obj)和Object.getOwnPropertyNames(obj)返回空数组 -
Proxy的get/settrap 对 # 字段无响应（引擎跳过代理，直连私有存储） -
'#field' in obj返回false；obj['#field']读不到，也绝不报错（只是 undefined）
与模块系统协同强化封装边界
私有字段的强封装需配合 ESM 的静态导出控制才能真正落地。单独使用 # 字段，若类被完整导出，外部仍可 new 实例并调用公有方法；而限制导出接口，才能让私有状态彻底“看不见且碰不到”：
- 导出工厂函数而非类：
export function createLogger() { return new Logger(); } - 只导出操作函数，隐藏实现类：
export { login, logout }，不导出AuthSession - 避免返回原始实例或敏感字段副本：
getRawData() { return { token: this.#token }; }→ 改为只返回校验结果或脱敏结构
