javascript中用class封装复杂数据结构的核心是通过私有字段（#）、getter/setter、方法抽象和契约设计实现真正封装，而非简单属性聚合；es2022私有字段确保状态一致性与信息隐藏，getter/setter控制访问逻辑，方法抽象屏蔽底层实现，静态工厂统一构造入口，最终以行为契约替代实现承诺。
JavaScript 中用 class 封装复杂数据结构，核心是把数据和操作它的方法组织在一起，同时控制访问、保证内部状态一致性。不是简单地把属性塞进 class，而是通过私有字段、getter/setter、方法抽象和契约设计来实现真正的封装。
用 # 私有字段保护内部状态
ES2022 引入的私有字段（#name）是封装的基础。它从语法层防止外部直接读写关键数据，避免破坏结构不变量。
- 比如链表类中，#head 和 #size 必须严格同步，暴露 raw head 会让外部误操作导致 size 错乱
- 私有字段不能被继承或反射（Object.keys、for...in 都看不到），真正实现信息隐藏
- 不要混用下划线约定（_head）代替 #head —— 那只是提示，不是约束
用 getter/setter 控制属性访问逻辑
对需要校验、转换或触发副作用的属性，用 getter/setter 替代公有字段。它们让“读写”变成可控的方法调用。
- 例如二叉搜索树的 root 属性：setter 可自动调用平衡逻辑，getter 可返回克隆节点防止外部篡改
- 避免在 getter 中做耗时计算（如遍历整个图找最大值），除非明确文档说明
- setter 中抛出 TypeError 比静默失败更利于调试，比如向只读结构插入元素时
用方法抽象操作，而非暴露底层结构
用户不该知道你是用数组、Map 还是多个对象拼成的图结构。所有交互都通过语义化方法进行。
- 提供 addEdge(from, to, weight) 而不是让用户自己操作 this.#adjacencyMap
- 迭代器方法（如 values()、entries()）应返回新迭代器，不暴露内部数组引用
- 批量操作（如 insertMany、removeWhere）比单次调用更高效，也减少用户出错机会
用静态方法和工厂函数统一构造入口
复杂结构常有多种初始化方式（空结构、从数组构建、从 JSON 解析），用静态方法或工厂函数集中管理，避免构造函数过载。
- class PriorityQueue { static fromArray(arr) { ... } }
- 工厂函数可返回子类实例，比如 Graph.fromJSON(data) 根据 type 字段返回 DirectedGraph 或 UndirectedGraph
- 构造函数保持精简，只处理必需参数；其余配置通过链式方法（new Stack().capacity(10).autoGrow(true)）或选项对象完成
封装的本质不是藏起来，而是定义清晰的边界和契约。只要 class 对外只承诺行为（“调用 insert() 后 contains() 返回 true”），不承诺实现（“用红黑树还是跳表”），就达到了数据结构封装的目的。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
