当前位置：首页 > 文章列表 > 文章 > 前端 > JavaScript 中使用 # 定义私有字段的方法

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

2026-04-03 11:39:31 0浏览收藏

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

如何用 # 符号在 JavaScript 类中定义真正的私有字段

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

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

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

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

例如：

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

私有方法也支持 # 语法

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

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

示例：

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