外观
09 - 两个实例为什么共享同一份数据:class、实例与方法绑定
摘要
两个报表对象明明分别创建,新增一行却同时改变了另一份报表。本文从这个误用出发,解释类、实例、方法绑定与继承查找,适合会编程但刚接触 Python 的读者,帮助你判断状态该放在哪里。
版本范围:Python 3.14;实现讨论以 CPython 常规构建为背景。示例仅使用标准语法,不依赖外部库。独立示例已在 Windows 上使用 CPython 3.14.0 与 3.13.7 执行通过。
1. 场景:对象创建了两次,列表却只有一份
下面是一个教学场景。日志汇总程序需要分别为两个服务生成报表。作者写了一个 Report 类,把 rows = [] 放在类的第一行,认为这是“报表包含一个列表”的声明。程序先为服务 A 添加异常,再输出服务 B,结果 B 的报表也有同一条异常。对象确实创建了两次,问题发生在列表的所有权上。
在某些语言中,类体内的字段声明可以描述每个实例的布局;Python 的类体本身则会被执行。执行到 rows = [] 时创建一个列表,把名称 rows 绑定到类的命名空间。后面创建实例,并不会自动再次执行整个类体。因此,两份实例沿着属性查找路径访问到了同一个类属性。只说“类变量是静态的”还不够,因为实例可以覆盖同名属性,而修改共享列表又不等于覆盖属性。 可进一步阅读BeanScope与作用域代理:类属性共享不等于容器作用域。
先记录“属性从哪里取得”和“动作写到了哪里”:实例身份独立,不保证沿属性路径取得的对象独立。 普通属性场景里,实例没有 rows 就沿类查找;类上的列表因此可被两份实例取得。第 3 篇的引用图在这里多了一层查找,访问得到某对象,不代表它由当前实例独占。
保持 a/b 和类列表不变,先预测 append、直接赋值、+= 三种动作是否让 b 看见新行。append 修改查找到的共享列表;赋值给 a 建立实例关联;列表 += 则先修改共享列表,再把返回引用写回 a。因此“a 的字典里终于有 rows”并不说明先前共享修改已经撤销。
2. class 是创建对象的组织方式,也会产生对象
2.1 类体不是实例初始化脚本
class(类)把一组行为和相关状态组织在一起。instance(实例)是通过类创建出来的具体对象。执行类定义时,Python 执行类体、收集名称,再创建类对象,并把类名绑定到它。函数定义也在这个过程中创建函数对象;它不会马上执行函数体。
例如 def add(self, row) 将 add 放到类的命名空间中,rows = [] 则将列表放到同一个空间中。这两项都属于类定义的结果。可以通过 vars(Report) 观察类的名称映射,但这个映射不是鼓励业务代码直接修改的普通实例字典。普通实例通常有自己的 __dict__ 保存实例属性;存在 __slots__ 或扩展类型时,存储方式可以不同。
self.rows = [] 出现在初始化方法里时,每执行一次这条语句都会创建新列表,并设置到对应实例。self 是实例方法的第一个参数,名称是约定,解释器不靠这个拼写识别对象。把它改成别的名字也能运行,但会破坏读者熟悉的约定,没有实用收益。
2.2 创建和初始化是两个步骤
常见的 Report("a") 调用可以在概念上分成分配对象与初始化对象。__new__ 负责创建并返回实例;当它返回对应类的实例时,随后执行 __init__ 为其配置状态。__init__ 必须返回 None,不能通过它把构造结果替换为其他对象。详见 Python 3.14 数据模型中的对象创建方法。
普通业务类通常只需定义 __init__。不可变类型的派生类或特殊构造需求才可能需要 __new__。不要为了“深入底层”在每个类里把两者都重写:额外代码会增加对象创建顺序的理解成本,并容易漏掉父类的协作约定。
初始化也没有自动调用所有父类初始化方法的保证。如果子类覆盖 __init__,需要根据设计显式调用 super().__init__()。遗漏它可能留下缺失属性;而重复直接调用多个父类又可能重复初始化共同祖先。理解调用链之后再选方式,比凭经验拼补丁更稳妥。
3. 读取、赋值与修改不是同一种操作
在不涉及数据描述符和自定义钩子的普通例子中,读取 a.rows 先看实例是否有 rows,没有再沿类及继承关系查找。下一篇会补上完整属性查找规则。本篇先关注最容易发生的三种操作。
a.rows.append("error") 先读取列表,再调用列表的方法。没有设置 a.rows,所以不会创建实例属性。共享状态仍然在原来的类属性中。
a.rows = [] 是赋值,把新的引用设置到实例。这时实例的同名属性遮蔽类属性,后续读取优先得到实例值。其他实例仍可以读到类列表,因此这项修补不会重置所有实例,更不会删除类列表里已有的数据。
a.rows += ["error"] 更容易误导。增强赋值先读取对象,尝试执行原地操作,再把结果写回目标。列表的原地加法会修改原列表,因此在实例尚未拥有独立列表时,共享类列表可能已经被修改。最终实例即使获得了 rows 属性,也不能撤销对共享对象的影响。工程上应直接在初始化阶段建立所有权,不靠第一次更新时碰巧覆盖。
图表将在阅读到此处时加载…
这张图回答的是引用归属,不是内存的物理排列。Python 对象的实际字段布局随类型与实现而异,不应把箭头解释成某个固定偏移量。
4. a.add(row) 为什么不用手动传 self
bound method(绑定方法)是携带目标实例和原始函数的可调用对象。访问 a.add 时,如果在类上找到普通函数,函数参与描述符协议,产生绑定到 a 的方法。这个方法的 __self__ 指向 a,__func__ 指向类上的原始函数。
因此 a.add("error") 的语义效果相当于 Report.add(a, "error")。后者明确传实例,前者通过绑定过程传入。类中的函数并没有为每个实例复制一份完整函数体;实例之间共享行为,区别主要来自传入哪个实例,以及该实例拥有何种状态。官方教程的方法对象说明给出了这一绑定关系。
绑定发生在属性访问阶段,不是函数定义阶段。把 a.add 保存到变量后,即使删掉名称 a,保存的方法仍然可以保持实例引用。比如长期注册的回调可能间接保留实例。这并不自动说明泄漏:只要回调的存活时间确实应该覆盖实例就合理;如果报表已结束却仍注册在全局回调表中,就应检查注销责任。
如果将普通函数直接赋给某个实例属性,它不会因为是函数就自动得到相同的绑定行为。描述符查找作用于类中的属性。这个区别解释了为什么实例上的临时替换函数有时缺少 self,类上的替换函数却会收到实例。测试里做方法替换前,应明确你替换的是哪一层。
classmethod(类方法)绑定类而非实例,常用来提供替代构造入口,例如根据配置创建对象;staticmethod(静态方法)不自动传实例或类,只是把相关函数放到类命名空间。没有依赖对象状态时也可以使用普通模块函数。不要为了面向对象形式而把每个工具函数包进类。
5. 最小实验:共享状态、独立状态与继承链
先画 BadReport 类到一份 rows 的关联,再让两实例读取它:创建次数二,列表数仍是一。移到 init 后,每次执行列表创建,A 添加三条而 B 保持空。增强赋值实验再查 vars 与 is,两者分别回答存放位置与对象身份。继承链实验增加查找顺序这一维度,不改变“沿路径找目标再执行”的判断。
保存为 examples/09_classes.py,从仓库根目录执行:
powershell
python docs/python/examples/09_classes.py完整代码如下,异常状态通过断言明确验证,不依赖随机结果:
python
"""独立示例:共享类状态、实例状态与方法绑定。"""
class BadReport:
rows = [] # 所有未覆盖 rows 的实例共享这一个列表。
def add(self, row):
self.rows.append(row)
class Report:
def __init__(self, name):
self.name = name
self.rows = [] # 每次初始化都创建新列表。
def add(self, row):
self.rows.append(row)
class Base:
def chain(self):
return ["Base"]
class Left(Base):
def chain(self):
return ["Left"] + super().chain()
class Right(Base):
def chain(self):
return ["Right"] + super().chain()
class Combined(Left, Right):
pass
if __name__ == "__main__":
bad_a, bad_b = BadReport(), BadReport()
bad_a.add("error")
assert bad_b.rows == ["error"]
print("shared:", bad_a.rows is bad_b.rows)
a, b = Report("a"), Report("b")
a.add("error")
assert b.rows == []
bound = a.add
assert bound.__self__ is a
assert bound.__func__ is Report.add
bound("warn")
Report.add(a, "info") # 显式传实例,与绑定调用完成同样操作。
print("separate:", a.rows, b.rows)
print("chain:", Combined().chain())
class AugmentedReport:
rows = []
left, right = AugmentedReport(), AugmentedReport()
left.rows += ["late-error"] # 先原地修改类列表,之后才写入实例属性。
assert "rows" in vars(left) and "rows" not in vars(right)
assert left.rows is vars(AugmentedReport)["rows"] is right.rows
print("augmented:", vars(left), right.rows)
print("mro:", [kind.__name__ for kind in Combined.__mro__])
class InitBase:
def __init__(self):
self.initialized.append("base")
class InitRight(InitBase):
def __init__(self):
self.initialized.append("right")
super().__init__()
class InitLeft(InitBase):
def __init__(self):
self.initialized = ["left"]
super().__init__()
class Cooperative(InitLeft, InitRight):
pass
class SkippingLeft(InitBase):
def __init__(self):
self.initialized = ["left"]
InitBase.__init__(self) # 反例:固定父类绕开MRO中的right。
class Skipping(SkippingLeft, InitRight):
pass
assert Cooperative().initialized == ["left", "right", "base"]
assert Skipping().initialized == ["left", "base"]
print("initialization:", Skipping().initialized, Cooperative().initialized)预期输出是共享检查为 True,独立报表 A 包含三条记录、B 为空,继承链为 ['Left', 'Right', 'Base']。前两项证明共享列表并非由“实例创建次数不足”导致,第三项用于说明下一节的继承顺序。
若只删除反例里的 rows = [],程序将因找不到属性而失败,不能算修复。修复要在每个实例进入可用状态之前建立自己的列表。若初始化从外部接收列表,也要决定是借用、浅复制还是转为不可变数据;写出 self.rows = rows 并不自动获得独占权。
6. super() 沿 MRO 继续,而不是固定找到直接父类
inheritance(继承)允许类复用或调整已有行为。多重继承下,MRO(Method Resolution Order,方法解析顺序)规定属性沿哪些类依次查找。Python 使用 C3 线性化来构建适用的顺序;顺序无法一致时,类创建会报错,而不是任意挑一条路径。
示例里 Combined.__mro__ 包含 Combined、Left、Right、Base、object。Left 的方法调用 super() 后,针对 Combined 实例会继续到 Right,因此输出不是 Left、Base。super() 返回的代理结合当前定义位置和实际对象的 MRO,搜索后继实现。它不是对某个父类名称的语法缩写。内置函数 super 的文档明确说明其搜索依赖动态 MRO。
协作式继承要求参与者遵守共同调用约定。例如每个参与类只处理自己负责的输入,并通过 super() 继续调用链。如果某个中间类直接跳到 Base.chain(self),后继的 Right 就可能被绕过;如果一部分参与者直接调用父类、一部分使用 super(),共同祖先可能被重复执行。
这并不意味着多重继承不可用。mixin(混入类)是提供一组小型行为、通常不承担完整业务身份的类,适合清晰的协作协议。但当你只是需要“报表使用一个存储客户端”,composition(组合)更直接:把客户端传给报表,让报表调用它。继承表达可替代关系,组合表达协作关系,二者的维护成本不同。
7. 踩坑后如何排查与设计
如果看到实例互相污染,先在本地可复现输入下检查 vars(instance) 是否包含目标属性,再看类上的同名对象。只比较 id(instance) 没有意义,因为问题可能出在更深一层。不要在生产日志里直接打印完整实例字典,其中可能包含凭据、用户信息或大对象;保留必要的字段名称、类型和脱敏身份即可。
类属性并不都是错误。计数策略、不可变默认标签、共享协议常量可以放在类上。关键是共享是否属于设计,以及谁有权修改。共享可变缓存则要进一步说明容量、失效、同步和租户隔离;把缓存藏在类上不会自动解决这些工程问题。
Python 也没有依靠双下划线实现的强访问控制。以 __name 开头的属性会发生名称改写,主要用于减少继承层次中的命名冲突;单下划线通常表示内部接口约定。调用方仍可能访问内部数据,因此边界还应由清晰接口、测试和代码审查维持。不要把命名规则当成安全隔离。
当报表仅承担数据存储时,可以继续学习 dataclasses,它帮助生成初始化、表示与比较等方法;可变字段要使用 default_factory 创建独立对象。不过自动生成方法仍需要正确的数据模型。比较字段、隐藏敏感字段以及嵌套共享对象等问题,不会因为用了装饰器就消失。
7.1 用所有权表代替“对象里都有些什么”
在较复杂的日志程序里,报表可能同时持有解析器、数据源和缓存。设计时可以为每项记录创建者、共享范围、允许修改者与结束时的清理者。例如报表行列表由报表创建且独占,格式策略由调用方提供并共享,文件则由资源管理层打开并在消费结束后关闭。这个表能直接暴露“对象通过属性能访问,所以由对象负责关闭”的错误推断。
从外部接收可变对象时,参数名或注解并不表达借用与转移。最好在接口文档中说明是否保存引用、是否允许后续修改、是否在结束时关闭。对于配置快照,可以将关键字段转成不可变数据;对于活的客户端连接,复制对象通常不等于复制底层连接,反而可能引入双重关闭。所有权判断要基于资源语义,而不是只根据能否调用 copy。
单继承下也应保持这个习惯。父类定义的状态若由子类随意覆盖,父类方法可能失去原假设;子类添加同名数据字段,可能遮蔽父类方法。继承能复用行为,也扩大了隐式协作范围。每增加一层继承,应检查初始化、属性命名和清理是否仍满足共同契约,而不是只检查新方法是否返回正确结果。
还可以用一次小型回归检验保护实例隔离:创建两份报表,只修改其中一份,检查另一份保持原值;再让两份实例引用同一个外部列表,明确观察共享是否属于允许行为。这样的断言针对所有权契约,不要求具体实现必须使用实例字典。以后改成数据类或其他存储方式,仍能保留测试价值。
类定义只执行一次也意味着默认对象创建时间值得关注。若字段来自调用某个函数,它的结果在类体执行时取得,后面实例不自动重新计算。需要每次创建时取得时间、随机标识或请求数据,就放到对应初始化或工厂入口,避免将过期值变成全类共享状态。
8. 进阶与面试:用调用链解释答案
为什么 Python 方法的第一个参数一般写 self? 它承接绑定方法自动传入的实例。名称是约定,机制是类上的函数通过属性访问参与绑定。回答到这里,再用 __self__ 和 __func__ 的实验支撑,比背“指向当前对象”更具体。
类属性和实例属性同名时谁优先? 本篇普通属性例子里实例优先;若类上是数据描述符,规则不同。面试时主动说明前提,下一篇使用可运行实验展示完整优先级。
super 为什么会调用到兄弟类? 它沿实际类的 MRO 从当前位置继续查找;协作式多重继承正是利用这种行为。用示例中的三个输出项解释,而不是将它称为解释器的奇怪特例。
进一步读源码前,可以先使用 type(obj)、vars(obj) 和 Class.__mro__ 重建对象关系。这些观测比直接进入 CPython C 源码更接近业务故障;它们也提供后续阅读属性访问实现时需要的事实背景。
实例属性回写与协作初始化的证据
从属性路径迁移到协作初始化路径
把查找目标从 rows 换成初始化方法,沿实际 MRO 继续查找的模型解释 super 为什么经过 Right;固定调用祖先则跳过这一段。状态是否独立与初始化是否完整是两个验收,前者用共享图,后者用 left/right/base 轨迹。第十篇补描述符优先级,使“从哪层得到属性”能覆盖更多对象。
属性回写实验提供三份证据:vars(left) 已有 rows,vars(right) 没有,但两者列表与类列表仍是同一个对象。这说明“实例字典里出现属性”不等于“共享状态已经隔离”。+= 先修改列表再回写引用,诊断要同时检查引用身份与存储位置。初始化链则分别打印 left/right/base 和 left/base:直接调用祖先会绕过 MRO 中的中间类;super() 只有各参与者遵守协作协议,才能把链完整走完。
独立能力任务:给反例增加第三个实例,在调用前后输出每个实例的 vars()、类列表与对象身份,再将列表初始化移入 __init__。验收要求不仅是输出正确,还应解释为什么“先 += 再改成实例属性”已经污染类列表。若属性读取会执行代码,下一步使用属性查找与描述符中的静态检查,避免诊断本身改变状态。
9. 结尾
类组织共享行为,实例承载具体状态,正确理解属性存放位置与方法绑定,才能解释对象为什么互相影响。
- 需要每个实例独立拥有的可变对象,应在初始化时明确创建或复制。
- 绑定方法携带实例与原始函数,访问路径决定是否自动传入实例。
super()沿实际 MRO 协作调用,组合和继承要根据关系选择。