封装

副标题 / 摘要 数据抽象的价值在于“更换实现不影响调用方”。本文展示违反抽象的例子与修复方案。 目标读者 关注代码可维护性的工程师 设计模块边界的团队 学习设计原则的开发者 背景 / 动机 当内部实现细节泄露到外部，任何变更都会引发连锁修改。 抽象被破坏会迅速放大维护成本。 核心概念 数据抽象：隐藏实现细节 封装：限制外部依赖 稳定接口：对外提供不变契约 实践指南 / 步骤 识别对内部结构的直接依赖 将访问收敛到接口方法 在接口层处理结构变化 为接口建立测试保护 可运行示例 # 反例：外部直接依赖内部结构 class UserStore: def __init__(self): self._users = [] # 内部结构 store = UserStore() # 外部直接访问内部结构 store._users.append({"name": "Alice"}) # 改为接口封装 class SafeUserStore: def __init__(self): self._users = [] def add(self, name): self._users.append({"name": name}) if __name__ == "__main__": s = SafeUserStore() s.add("Bob") print(s._users) 解释与原理 外部直接访问内部数据结构会强绑定实现细节。 一旦内部结构调整，外部调用必须同步修改。 常见问题与注意事项 私有成员就不会被访问吗？ 语言限制不同，需要靠规范与评审保护。 ...

副标题 / 摘要 封装不是“把字段设为 private”，而是建立稳定边界，让变化被隔离。本文解释封装的工程价值与落地方法。 目标读者 写业务系统但经常“改一处坏一片”的工程师 希望提升模块边界设计的开发者 负责代码评审和架构演进的技术负责人 背景 / 动机 没有封装，系统就像没有隔间的办公室：任何一个变化都会影响到其他部分。 封装能让变化局部化、减少耦合、提高可读性与可测试性。 核心概念 信息隐藏：内部实现细节不暴露给外部 稳定边界：对外只暴露行为和契约 高内聚、低耦合：模块内紧密相关，模块间依赖最小 实践指南 / 步骤 先定义对外行为：先有接口，再有实现。 隐藏数据结构：不要让外部直接依赖内部表示。 用方法维护不变量：禁止外部绕过规则直接改数据。 把变化集中在模块内部：外部只看到稳定契约。 为封装加测试：通过行为测试保证边界稳定。 可运行示例 class BankAccount: def __init__(self, balance: int): self._balance = balance def deposit(self, amount: int) -> None: if amount <= 0: raise ValueError("amount must be positive") self._balance += amount def withdraw(self, amount: int) -> None: if amount <= 0: raise ValueError("amount must be positive") if amount > self._balance: raise ValueError("insufficient balance") self._balance -= amount def balance(self) -> int: return self._balance if __name__ == "__main__": acc = BankAccount(100) acc.deposit(50) acc.withdraw(30) print(acc.balance()) 解释与原理 封装的本质是 把“规则”放到模块内部。 外部只调用方法，不触碰内部状态，这样就能保证不变量始终成立。 当实现方式变化时，只要接口不变，外部代码无需调整。 ...