JavaScript / TypeScript / 系统课时

控制成员可见性

控制成员可见性

访问修饰符用于规定类成员能被谁读取或调用。TypeScript 的 private 主要提供编译期约束,而 # 私有字段由 JavaScript 运行时强制隔离。本课将通过继承和私有状态示例,明确不同可见性规则的适用边界。

学习目标

  • 区分 public、protected 与 private 的访问范围
  • 理解 TypeScript private 和 # 私有字段的差异
  • 为公开接口、继承扩展点和内部状态选择合适修饰符

三种访问修饰符

public 成员可在类内部、子类和实例外部访问,也是类成员的默认可见性。protected 成员只能在当前类及其子类中访问。private 成员只能在声明它的类内部访问。

ts
class Employee {
  constructor(
    public readonly name: string,
    protected department: string,
    private salary: number
  ) {}

  describe(): string {
    return `${this.name} works in ${this.department}`;
  }

  getSalary(): number {
    return this.salary;
  }
}

class Manager extends Employee {
  changeDepartment(next: string): void {
    this.department = next;
  }
}

const manager = new Manager("Alice", "Engineering", 20000);
manager.changeDepartment("Platform");

console.log(manager.describe());
console.log(manager.getSalary());

运行方式:

bash
npx tsc employee.ts --target ES2022 --strict && node employee.js

预期输出:

text
Alice works in Platform
20000

外部代码可以访问 name 和公开方法,但不能直接访问 department 或 salary。子类可以修改 protected department,却不能读取父类的 private salary。

编译期 private 的边界

TypeScript 的 private 会在类型检查阶段阻止非法访问,但普通 private 属性通常仍会被编译为常规 JavaScript 属性。它的目标是约束 TypeScript 源码,而不是提供运行时安全边界。

ts
class ApiKeyStore {
  private apiKey = "demo-key";

  reveal(): string {
    return this.apiKey;
  }
}

const store = new ApiKeyStore();
console.log(store.reveal());

// 取消下一行注释后,TypeScript 会报告私有成员访问错误。
// console.log(store.apiKey);

运行方式:

bash
npx tsc api-key-store.ts --target ES2022 --strict && node api-key-store.js

预期输出:

text
demo-key

如果把被注释的访问语句恢复,编译器会触发 TS2341,阻止类外直接读取 apiKey。这类限制可以提升封装性,但不要用它保护必须抵御运行时读取的秘密。

使用 # 私有字段

以 # 开头的字段属于 ECMAScript 私有字段。它不仅参与语法和类型检查,还由 JavaScript 运行时保证只能在声明该字段的类体内访问。

ts
class Counter {
  #value = 0;

  increment(): number {
    this.#value += 1;
    return this.#value;
  }

  current(): number {
    return this.#value;
  }
}

const counter = new Counter();
console.log(counter.increment());
console.log(counter.current());
console.log(Object.prototype.hasOwnProperty.call(counter, "#value"));

运行方式:

bash
npx tsc counter.ts --target ES2022 --strict && node counter.js

预期输出:

text
1
1
false

结果中的 false 表明实例上不存在名为 "#value" 的普通字符串属性。即使通过方括号访问同名字符串,也不会得到真正的私有字段;直接在类外写 counter.#value 则会产生语法或编译错误。

如何选择可见性

公开给调用者的稳定能力使用 public,例如查询状态或执行业务动作。只希望子类复用或改写的扩展点使用 protected,但应谨慎增加,因为它会让父类实现与子类形成长期耦合。

仅供当前类实现使用的成员可声明为 private。若必须获得真正的运行时私有性,或者类会以 JavaScript 形式分发给非 TypeScript 调用者,应优先考虑 # 私有字段。需要调试、序列化或被装饰器访问的字段,则要确认工具链是否支持 # 字段。

易混淆点

private 和 protected 会影响类类型的兼容性:含有这些成员的两个类,只有相关成员来自同一个类声明体系时才可能兼容。它们因此比只有公开成员的类更接近名义类型。

访问修饰符不等于权限系统。它们只能约束代码结构,不能替代接口鉴权、数据加密或服务端访问控制。敏感信息也不应因为放进私有字段就被认为已经安全存储。

本课总结

  • public 面向调用者,protected 面向继承,private 面向当前类实现
  • TypeScript private 主要在编译期生效,# 私有字段具有运行时隔离
  • 可见性用于维护封装边界,不能替代真正的安全控制

下一课预告

下一课将继续完善类模型,学习只读成员、静态成员与继承中的类型约束,并把可见性规则应用到更完整的对象设计中。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

控制成员可见性

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通