当前位置：首页 > 文章列表 > 文章 > python教程 > Weakref使用技巧：防止循环引用泄露

Weakref使用技巧：防止循环引用泄露

2026-04-12 13:48:33 0浏览收藏

本文深入解析了 Python 中 weakref 模块的核心价值——精准打破循环引用以杜绝内存泄漏，特别聚焦于父子对象等典型场景下如何用 weakref.ref 安全替代强反向引用，并强调“只在需要时动态解引用、始终检查 None”的实践原则；同时介绍了 WeakKeyDictionary、WeakValueDictionary、WeakSet 和 finalize 等实用工具及其关键注意事项，帮助开发者写出更健壮、内存友好的 Python 代码。

weakref 如何正确使用来避免循环引用导致内存泄漏

在 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 weakref
class 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 对象获取实例，可能为 None
p = Parent()
c = Child(p)
print(c.parent is p)  # True
del p
print(c.parent)       # None — 安全，不崩溃

注意：self._parent_ref() 是动态取值，不是缓存强引用；每次使用都应检查是否为 None。