JavaScript 私有字段通过 # 前缀实现语法级私有性，仅类内可访问、不可继承、不可枚举，不参与 JSON.stringify 等遍历，区别于闭包/WeakMap 模拟，原生支持、类型安全、调试隐藏，但不支持动态访问或私有方法。

JavaScript 中的私有字段是通过 # 前缀声明的类成员，它们在类外部完全不可访问、不可枚举、也无法被继承，从而实现了语法层面的真正私有性。

私有字段的语法和基本行为

私有字段必须在类体中用 # 开头显式声明（如 #count = 0），不能在实例上动态添加。它们只在声明该字段的类内部可读写，子类或外部代码访问会直接报 TypeError。

• 不参与 for...in、Object.keys() 或 JSON.stringify()
• 不能被子类同名字段覆盖（子类定义 #count 是另一个独立私有字段）
• 支持私有 getter/setter（如 get #value() { return this.#_value; }）

与传统“模拟私有”的根本区别

过去常用闭包或 WeakMap 模拟私有，但存在局限：闭包难以在继承中复用，WeakMap 需手动管理映射且容易内存泄漏。而 # 字段由引擎原生支持，无需额外结构，也不依赖作用域链或全局注册表。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 不需要构造函数内初始化（可在类体中直接赋默认值）
• 类型检查工具（如 TypeScript）能识别并校验访问合法性
• 调试器通常隐藏私有字段，体现封装意图

实际使用中的关键细节

私有字段不是万能的——它不阻止反射（Reflect.ownKeys() 仍能看到带 # 的字符串）、不能用于私有静态字段以外的静态场景（静态私有字段需用 static #name），且暂不支持私有方法（但私有 getter/setter 可间接实现逻辑封装）。

立即学习“Java免费学习笔记（深入）”；

• 私有方法目前只能靠私有 getter/setter + 私有字段配合模拟
• 私有字段名在运行时是固定标识符，不能拼接或计算（this[#key] 不合法）
• 类外尝试 obj.#field 或 obj['#field'] 均会抛错，无降级行为

不复杂但容易忽略：私有字段让 JavaScript 第一次拥有了无需约定、不可绕过的私有机制，是面向对象封装的重要落地。