JavaScript / TypeScript / 系统课时
控制成员可见性
控制成员可见性
访问修饰符用于规定类成员能被谁读取或调用。TypeScript 的 private 主要提供编译期约束,而 # 私有字段由 JavaScript 运行时强制隔离。本课将通过继承和私有状态示例,明确不同可见性规则的适用边界。
学习目标
- 区分
public、protected与private的访问范围 - 理解 TypeScript
private和#私有字段的差异 - 为公开接口、继承扩展点和内部状态选择合适修饰符
三种访问修饰符
public 成员可在类内部、子类和实例外部访问,也是类成员的默认可见性。protected 成员只能在当前类及其子类中访问。private 成员只能在声明它的类内部访问。
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());运行方式:
npx tsc employee.ts --target ES2022 --strict && node employee.js预期输出:
Alice works in Platform
20000外部代码可以访问 name 和公开方法,但不能直接访问 department 或 salary。子类可以修改 protected department,却不能读取父类的 private salary。
编译期 private 的边界
TypeScript 的 private 会在类型检查阶段阻止非法访问,但普通 private 属性通常仍会被编译为常规 JavaScript 属性。它的目标是约束 TypeScript 源码,而不是提供运行时安全边界。
class ApiKeyStore {
private apiKey = "demo-key";
reveal(): string {
return this.apiKey;
}
}
const store = new ApiKeyStore();
console.log(store.reveal());
// 取消下一行注释后,TypeScript 会报告私有成员访问错误。
// console.log(store.apiKey);运行方式:
npx tsc api-key-store.ts --target ES2022 --strict && node api-key-store.js预期输出:
demo-key如果把被注释的访问语句恢复,编译器会触发 TS2341,阻止类外直接读取 apiKey。这类限制可以提升封装性,但不要用它保护必须抵御运行时读取的秘密。
使用 # 私有字段
以 # 开头的字段属于 ECMAScript 私有字段。它不仅参与语法和类型检查,还由 JavaScript 运行时保证只能在声明该字段的类体内访问。
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"));运行方式:
npx tsc counter.ts --target ES2022 --strict && node counter.js预期输出:
1
1
false结果中的 false 表明实例上不存在名为 "#value" 的普通字符串属性。即使通过方括号访问同名字符串,也不会得到真正的私有字段;直接在类外写 counter.#value 则会产生语法或编译错误。
如何选择可见性
公开给调用者的稳定能力使用 public,例如查询状态或执行业务动作。只希望子类复用或改写的扩展点使用 protected,但应谨慎增加,因为它会让父类实现与子类形成长期耦合。
仅供当前类实现使用的成员可声明为 private。若必须获得真正的运行时私有性,或者类会以 JavaScript 形式分发给非 TypeScript 调用者,应优先考虑 # 私有字段。需要调试、序列化或被装饰器访问的字段,则要确认工具链是否支持 # 字段。
易混淆点
private 和 protected 会影响类类型的兼容性:含有这些成员的两个类,只有相关成员来自同一个类声明体系时才可能兼容。它们因此比只有公开成员的类更接近名义类型。
访问修饰符不等于权限系统。它们只能约束代码结构,不能替代接口鉴权、数据加密或服务端访问控制。敏感信息也不应因为放进私有字段就被认为已经安全存储。
本课总结
public面向调用者,protected面向继承,private面向当前类实现- TypeScript
private主要在编译期生效,#私有字段具有运行时隔离 - 可见性用于维护封装边界,不能替代真正的安全控制
下一课预告
下一课将继续完善类模型,学习只读成员、静态成员与继承中的类型约束,并把可见性规则应用到更完整的对象设计中。