weakref 的核心用途是打破循环引用以防内存泄漏,即不持有强引用而仅临时获取对象,允许其被及时销毁;典型应用是在子对象对父对象的反向引用中使用 weakref.ref,并每次调用后检查是否为 None。

在 Python 中,weakref 的核心用途之一就是打破循环引用,防止对象无法被垃圾回收(GC),从而避免内存泄漏。关键在于:**不持有强引用,只在需要时临时获取对象,且允许对象在无其他强引用时被及时销毁。**
理解循环引用为何导致泄漏
Python 主要靠引用计数 + 周期性 GC 清理循环引用。但若两个对象互相持强引用(如父对象存子列表,子对象又存父引用),即使外部不再使用它们,引用计数也不为 0,只能依赖 GC。而 GC 并非实时触发,尤其在 CPython 中,某些场景(如含 __del__ 方法的对象)可能完全不被 GC 处理,造成泄漏。
例如:
class Parent:
def __init__(self):
self.children = []
class Child:
def init(self, parent):
self.parent = parent # 强引用父对象
parent.children.append(self)
p = Parent()
c = Child(p) # p ↔ c 形成循环引用
del p, c # 对象仍驻留内存,可能不被回收
用 weakref 替代强引用的关键位置
应在“从属方”对“主控方”的反向引用处使用 weakref,即子对象引用父对象、缓存引用目标、回调中保存对象等场景。
- 用
weakref.ref包装父对象,调用时加()获取(可能返回None) - 用
weakref.WeakKeyDictionary或WeakValueDictionary管理映射关系,键或值被销毁时自动清理条目 - 避免在
__del__中访问 weakref 对象(此时对象可能已部分析构)
典型安全写法示例
修正上面的父子关系:
import weakrefclass Parent: def init(self): self.children = []
class Child: def init(self, parent): self._parent_ref = weakref.ref(parent) # 弱引用 parent.children.append(self)
@property def parent(self): return self._parent_ref() # 调用 ref 对象获取实例,可能为 Nonep = Parent() c = Child(p) print(c.parent is p) # True del p print(c.parent) # None — 安全,不崩溃
注意:
self._parent_ref()是动态取值,不是缓存强引用;每次使用都应检查是否为None。其他实用 weakref 工具与注意事项
weakref.finalize可注册对象销毁时的清理逻辑,比__del__更可靠;weakref.WeakSet适合管理一组可随时消失的对象。
- 不要对不可弱引用类型(如 int、str、tuple)创建 weakref,会报
TypeError - 避免长期持有
weakref.ref实例本身(它自己也是对象),若 ref 对象还活着,目标对象无法被回收 - 多线程中使用 weakref 是安全的,但访问解引用结果仍需自行同步










