JavaScript 中使用 # 定义私有字段的方法

JavaScript 中以 # 开头的私有字段是 ES13（ECMAScript 2022）正式引入的语言级访问控制机制，它不是模拟、约定或闭包技巧，而是真正意义上的私有——外部既无法读取、修改，也无法检测其存在，更不会出现在 for...in、Object.keys() 或 JSON.stringify 等反射与序列化操作中；它强制限定于声明类的内部使用，支持私有字段和私有方法，并具备严格的语法约束与跨浏览器广泛兼容性，为 JavaScript 类提供了前所未有的封装严谨性与代码安全性。

JavaScript 类中用 # 符号定义的字段是真正的私有字段（Private Fields），这是 ECMAScript 2022（ES13）正式标准化的语法，由类字段提案（Class Fields）引入。它不是模拟、不是约定、也不是闭包封装，而是语言层面的访问控制机制——外部无法读取、修改、甚至无法检测其是否存在。

私有字段的声明与基本用法

在类内部，以 # 开头的标识符即为私有字段或私有方法，必须在类体顶层声明（不能在方法内动态创建），且只能在该类的内部方法中访问：

• 声明时直接写 #fieldName = value（可带初始值）
• 在构造函数或任何实例方法中，通过 this.#fieldName 访问
• 不能在类外部、子类中、静态方法中（除非是同一类的静态方法）访问

例如：

class Counter {
  #count = 0; // 私有字段，初始化为 0
<p>increment() {
this.#count++; // ✅ 合法：类内部访问
}</p><p>getCount() {
return this.#count; // ✅ 合法
}
}</p><p>const c = new Counter();
c.increment();
console.log(c.getCount()); // 1
console.log(c.#count);     // ❌ SyntaxError：非法访问私有字段</p>

私有方法也支持 # 语法

私有方法同样以 # 开头，只能被同一类的其他方法调用，不可被继承或外部调用：

• 定义：#privateMethod() { ... }
• 调用：this.#privateMethod()（仅限当前类的实例方法或构造函数中）
• 子类中无法重写、也无法调用父类的私有方法

示例：

class Logger {
  #log(message) {
    console.log(`[LOG] ${message}`);
  }
<p>info(msg) {
this.#log(<code>INFO: ${msg}</code>); // ✅
}
}</p><p>class SecureLogger extends Logger {
debug(msg) {
// this.#log(<code>DEBUG: ${msg}</code>); // ❌ 报错：私有方法不可继承
}
}</p>

注意：私有字段不参与 for...in / Object.keys() / JSON.stringify

因为私有字段不属于对象自身的可枚举属性，也不属于原型链上的属性，所以所有标准反射和序列化 API 都完全忽略它们：

• Object.keys(instance) 不包含 # 字段
• for (let key in instance) 遍历不到
• JSON.stringify(instance) 不序列化私有字段
• instance.hasOwnProperty('#count') 返回 false（且 '#count' 本身不是合法属性名）

这进一步印证了它的“真正私有”性——不是隐藏，而是根本不可见。

限制与常见误区

• 私有字段名必须是标识符（不能是计算属性，如 #[expr] 不合法）
• 不能在类外部定义或补丁式添加（c.#newField = 1 会抛出 SyntaxError）
• 私有字段与公有字段同名不冲突：this.count 和 this.#count 可共存
• 目前暂不支持私有 static #field（但私有静态方法 static #method() 是允许的）

浏览器兼容性方面，Chrome 74+、Firefox 90+、Safari 14.1+、Node.js 14.6+ 均已支持，构建工具（如 Babel）也可通过插件降级处理（但会转为 WeakMap 模拟，失去运行时强制保护）。

到这里，我们也就讲完了《JavaScript 中使用 # 定义私有字段的方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！