一个类应仅有一个变化原因,即修改时只因单一职责变动;若同时承担数据持有、业务计算、外部交互,则职责过载,需按变化诱因拆分为User、EmailValidator、EmailService、UserRepository等独立类。

一个类只该有一个变化原因,不是“看起来功能少”,而是“改一处不会牵连其他地方”。违反SRP的类往往在加个日志、换种存储方式或新增校验逻辑时,就得动它几十行——这不是重构,是踩雷。
怎么识别一个类已经职责过载
看它有没有同时做「数据持有」「业务计算」「外部交互」三类事。比如下面这个 User 类:
class User:
def __init__(self, name, email):
self.name = name
self.email = email
<pre class="brush:php;toolbar:false;">def send_welcome_email(self):
import smtplib
# 发邮件逻辑混在里面
def validate_email(self):
return "@" in self.email
def save_to_db(self):
import sqlite3
# 直接写SQL
问题很典型:
立即学习“Python免费学习笔记(深入)”;
-
send_welcome_email依赖 SMTP 配置和网络,一升级邮件服务商就得改这个类 -
validate_email是纯逻辑,但和发信、存库耦在一起,单元测试必须 mock 外部模块 -
save_to_db硬编码 SQLite,换成 PostgreSQL 就得重写,还污染了User的核心语义
拆分时优先按“变化诱因”而不是“功能相似性”
别因为“都是用户相关操作”就全塞进一个类。真正该拆的边界是:谁变、为什么变、变的时候影响谁。
上面例子中,三个变化诱因明显不同:
将测试、lint、构建和文档流程编码为命名的Python会话,以便人类和代理每次运行相同的workflow。
- 邮箱格式规则变 → 只影响校验逻辑
- 邮件模板/渠道变 → 只影响通知服务
- 数据库选型/表结构变 → 只影响持久化层
所以合理拆法是:
class User:
def __init__(self, name, email):
self.name = name
self.email = email
<p>class EmailValidator:
def is_valid(self, email: str) -> bool:
return "@" in email</p><p>class EmailService:
def send_welcome(self, user: User):</p><h1>实际发信逻辑,可注入 SMTP 客户端</h1><p>class UserRepository:
def save(self, user: User):</p><h1>用抽象的 db 接口,不绑定具体实现</h1><p>注意:UserRepository 不该持有数据库连接实例,而应通过构造函数或方法参数传入——否则又把连接管理职责悄悄塞回去了。
函数级 SRP 比类级更容易被忽略
很多人盯着类拆,却放任一个 process_order 方法干五件事:查库存、扣减、生成订单号、发消息、更新缓存。这种函数哪怕放在职责清晰的类里,照样违背 SRP。
判断标准很简单:如果这个函数里出现两个以上 import(尤其来自不同领域,比如 redis 和 requests),或者有两段用不同异常类型处理的逻辑(ConnectionError vs ValueError),基本可以确定它超载了。
安全的拆法是让每个子函数只依赖一种外部能力:
-
check_stock()→ 只和库存服务交互,抛StockInsufficientError -
generate_order_id()→ 纯函数,无副作用,不 import 任何东西 -
publish_order_event()→ 只和消息队列打交道,抛KafkaConnectionError
主流程变成组合调用,而不是嵌套胶水代码。
最常被绕过的点是:职责划分不是越细越好,而是要对齐团队的修改节奏。如果你们组每周都同时改校验规则和邮件模板,硬拆成两个类反而增加协作成本。SRP 的真实目标不是制造更多文件,而是让每次 git commit 的改动范围可控、可预测、可回滚。

















