JavaScript ES6类私有字段#的使用方法

木白

发布时间：2026-10-21 | 5人浏览过

原创

在 JavaScript 中，长期以来我们依靠命名约定（如以下划线 _ 开头）来模拟私有属性，但这并不能真正阻止外部代码的访问和修改。ES2022（通常归类为现代 ES6+ 特性）正式引入了以 # 开头的私有字段语法。这种机制由引擎强制执行，任何在类外部尝试读取或写入私有字段的操作都会直接抛出语法错误，从而实现了真正意义上的数据封装。

本教程将带你从零开始，在一个具体的 BankAccount 类中实现余额的私有化保护。你将看到如何声明私有字段、如何在类内部安全地操作它，以及当外部试图非法访问时浏览器的真实反应。

JavaScript ES6类私有字段#的使用方法

使用 # 前缀在类中声明私有字段

要实现私有字段，你只需要一个支持现代 ECMAScript 标准的浏览器环境（如 Chrome 74+、Firefox 90+ 或 Safari 15+）以及一个代码编辑器。无需安装任何额外的转译工具即可直接在控制台或现代项目中运行。

1. 使用 # 前缀声明私有字段

首先，我们需要定义一个类，并在其中声明一个私有字段。与普通公共字段不同，私有字段必须在类体中显式声明，且名称必须以 # 开头。

创建一个名为 BankAccount 的类。在构造函数之外或之内，使用 #balance 来声明私有属性。注意，这个字段不能在类外部通过 this.#balance 以外的方式隐式创建。

class BankAccount {
  // 声明私有字段 #balance
  #balance;

  constructor(initialBalance) {
    // 在构造函数中初始化私有字段
    this.#balance = initialBalance;
  }
}

在这段代码中，#balance 是 BankAccount 实例的一部分，但它被锁定在类的内部作用域中。如果你尝试在实例化后直接访问它，例如 account.#balance，代码将无法通过解析阶段。

JavaScript ES6类私有字段#的使用方法

通过公共方法安全操作私有数据

2. 通过公共方法访问私有数据

既然外部无法直接读取 #balance，我们需要提供受控的公共接口（Getter/Setter 或普通方法）来与这些数据交互。这是封装的核心：隐藏实现细节，只暴露必要的行为。

在类中添加 getBalance 和 deposit 方法。在这些方法内部，你可以自由地使用 this.#balance 进行读取和计算，因为它们在类的词法作用域内。

class BankAccount {
  #balance;

  constructor(initialBalance) {
    this.#balance = initialBalance;
  }

  // 公共方法：获取余额
  getBalance() {
    return this.#balance;
  }

  // 公共方法：存款
  deposit(amount) {
    if (amount > 0) {
      this.#balance += amount;
      return true;
    }
    return false;
  }
}

// 测试代码
const myAccount = new BankAccount(100);
console.log(myAccount.getBalance()); // 输出: 100
myAccount.deposit(50);
console.log(myAccount.getBalance()); // 输出: 150

此时，myAccount 对象对外只展示了 getBalance 和 deposit 方法。内部的 #balance 虽然存在，但对外部代码是不可见的黑盒。

JavaScript ES6类私有字段#的使用方法

2. 通过公共方法访问私有数据

3. 验证外部访问的限制

为了确认私有字段的有效性，我们需要尝试从类外部直接访问它。这一步不是为了成功执行，而是为了观察预期的错误行为。

在控制台或脚本中，尝试执行 console.log(myAccount.#balance)。你会发现，这甚至不是一个运行时错误，而是一个语法错误（SyntaxError）。这意味着代码在运行之前就被 JavaScript 引擎拒绝了。

// 下面的代码会导致 SyntaxError: Private field '#balance' must be declared in an enclosing class
console.log(myAccount.#balance);

这种严格的检查确保了没有任何“黑客”手段可以通过常规的对象属性访问方式来篡改你的核心数据。即使使用 Object.keys() 或 for...in 循环遍历对象，私有字段也不会出现在枚举结果中。

4. 定义私有方法

除了属性，JavaScript 也允许定义私有方法。这对于那些只在类内部使用的辅助逻辑非常有用，可以避免污染类的公共 API。

假设我们需要一个复杂的利息计算逻辑，但不希望用户直接调用它。我们可以定义一个 #calculateInterest 方法。

class BankAccount {
  #balance;
  #interestRate = 0.05; // 私有字段也可以有初始值

  constructor(initialBalance) {
    this.#balance = initialBalance;
  }

  // 私有方法：计算利息
  #calculateInterest() {
    return this.#balance * this.#interestRate;
  }

  // 公共方法：应用利息
  applyInterest() {
    const interest = this.#calculateInterest(); // 内部调用私有方法
    this.#balance += interest;
    return interest;
  }

  getBalance() {
    return this.#balance;
  }
}

const savings = new BankAccount(1000);
savings.applyInterest();
console.log(savings.getBalance()); // 输出: 1050

在这个例子中，#calculateInterest 只能在 applyInterest 或其他类内部方法中被调用。如果尝试执行 savings.#calculateInterest()，同样会抛出语法错误。

JavaScript ES6类私有字段#的使用方法

定义并调用私有方法

5. 检查私有字段的存在性

在某些情况下，你可能需要在类内部判断某个私有字段是否已被初始化。由于直接使用未初始化的私有字段会抛出引用错误，我们需要使用 in 操作符来进行安全检测。

语法格式为：#fieldName in object。这在处理可选配置或延迟初始化时非常有用。

class ConfigurableService {
  #apiKey;

  constructor(config) {
    if (config && config.key) {
      this.#apiKey = config.key;
    }
  }

  fetchData() {
    // 使用 in 操作符检查私有字段是否存在
    if (#apiKey in this) {
      console.log('Using API Key:', this.#apiKey);
    } else {
      console.log('No API Key configured');
    }
  }
}

const service1 = new ConfigurableService({ key: '12345' });
const service2 = new ConfigurableService({});

service1.fetchData(); // 输出: Using API Key: 12345
service2.fetchData(); // 输出: No API Key configured

注意，in 操作符是唯一能安全检测私有字段存在性的方式。不要尝试使用 this.#apiKey !== undefined，因为如果字段从未被声明或初始化，访问它本身就会报错。

JavaScript ES6类私有字段#的使用方法