JavaScript 私有字段通过 # 前缀实现语法级私有性,仅类内可访问、不可继承、不可枚举,不参与 JSON.stringify 等遍历,区别于闭包/WeakMap 模拟,原生支持、类型安全、调试隐藏,但不支持动态访问或私有方法。

JavaScript 中的私有字段是通过 # 前缀声明的类成员,它们在类外部完全不可访问、不可枚举、也无法被继承,从而实现了语法层面的真正私有性。
私有字段的语法和基本行为
私有字段必须在类体中用 # 开头显式声明(如 #count = 0),不能在实例上动态添加。它们只在声明该字段的类内部可读写,子类或外部代码访问会直接报 TypeError。
- 不参与
for...in、Object.keys()或JSON.stringify() - 不能被子类同名字段覆盖(子类定义
#count是另一个独立私有字段) - 支持私有 getter/setter(如
get #value() { return this.#_value; })
与传统“模拟私有”的根本区别
过去常用闭包或 WeakMap 模拟私有,但存在局限:闭包难以在继承中复用,WeakMap 需手动管理映射且容易内存泄漏。而 # 字段由引擎原生支持,无需额外结构,也不依赖作用域链或全局注册表。
- 不需要构造函数内初始化(可在类体中直接赋默认值)
- 类型检查工具(如 TypeScript)能识别并校验访问合法性
- 调试器通常隐藏私有字段,体现封装意图
实际使用中的关键细节
私有字段不是万能的——它不阻止反射(Reflect.ownKeys() 仍能看到带 # 的字符串)、不能用于私有静态字段以外的静态场景(静态私有字段需用 static #name),且暂不支持私有方法(但私有 getter/setter 可间接实现逻辑封装)。
立即学习“Java免费学习笔记(深入)”;
- 私有方法目前只能靠私有 getter/setter + 私有字段配合模拟
- 私有字段名在运行时是固定标识符,不能拼接或计算(
this[#key]不合法) - 类外尝试
obj.#field或obj['#field']均会抛错,无降级行为
不复杂但容易忽略:私有字段让 JavaScript 第一次拥有了无需约定、不可绕过的私有机制,是面向对象封装的重要落地。











