Python类职责划分与边界解析【教程】

Python类设计核心是单一职责，即每个类只做一件事并做好；职责边界指类应承担的行为与数据范围，需通过影响范围、存储替换成本和测试便捷性三问判断；常见越界行为包括模型类发HTTP请求、业务类生成HTML、硬编码日志监控等，应拆分服务、分离数据与展示、用装饰器或中间件解耦；可用Protocol或ABC声明依赖协议，优先组合而非继承以增强灵活性与可测性。

Python类设计的核心不是堆砌功能，而是让每个类只做一件事，并且把这件事做好。边界划不清，职责不明确，代码就会快速变得难以理解、测试和修改。

什么是类的职责边界

职责边界指的是一个类应该承担哪些行为、持有哪些数据，以及它不该碰哪些事。比如，一个User类负责管理用户身份信息（姓名、邮箱、密码哈希），但不该负责发邮件、连数据库或校验手机号格式——这些是其他类或函数的活。

判断边界是否合理，可以问三个问题：

• 这个类修改后，是否会影响其他不相关的业务逻辑？
• 如果要换一种存储方式（比如从MySQL换成Redis），需要改几个类？理想情况是只改1个数据访问类。
• 单元测试时，是否能用几行mock就覆盖全部行为？如果要启动Web服务、读配置、连第三方API才能测，说明职责太重。

常见越界行为与重构建议

以下是一些高频“破界”现象，附带轻量级重构方向：

• 在模型类里写HTTP请求：比如Order.pay()直接调用requests.post()。应拆出PaymentService类，由上层协调调用。
• 一个类既处理业务又生成前端HTML：如ReportGenerator.render_html()。应分离为ReportDataBuilder（纯数据） + 模板引擎（Jinja等）。
• 把日志、监控、事务控制硬编码进业务方法：比如每个方法开头都有logger.info(...)和db.transaction()。应通过装饰器、上下文管理器或AOP风格中间件统一注入。

用协议和接口辅助边界表达

Python虽无interface关键字，但可用typing.Protocol或抽象基类（ABC）显式声明“这里需要什么能力”，而不是“这里要用哪个具体类”。例如：

定义一个Notifier协议，只要对象有send(self, message: str)方法就算符合；EmailNotifier、SmsNotifier各自实现，业务类只依赖协议——这样边界清晰，替换成本趋近于零。

协作关系比继承更能守住边界

优先用组合（has-a）而非继承（is-a）。比如不要让AdminUser继承User再塞一堆管理权限逻辑，而应让AdminUser持有一个PermissionChecker实例。这样权限策略可单独测试、独立演进，User类也保持干净。

组合还天然支持运行时替换：同一份用户数据，测试时注入MockPermissionChecker，生产时换真实实现，无需改任何业务代码。