如何在Python中使用weakref弱引用避免循环引用导致的内存泄露？-Python教程-PHP中文网

weakref.ref 返回可调用对象，须显式调用获取原对象并判空；WeakKeyDictionary 要求 key 可哈希；proxy 易抛 ReferenceError，不推荐；__del__ 会干扰弱引用行为；weakref 不解决强引用泄露。

如何在python中使用weakref弱引用避免循环引用导致的内存泄露？

weakref.ref 不能直接当对象用，得手动调用

很多人写 weakref.ref(obj) 后直接拿返回值当原对象用，结果报 TypeError: 'weakref' object is not callable 或属性访问失败。这是因为 weakref.ref 返回的是一个可调用对象，不是原对象的代理——它本身不支持点号访问属性，必须显式调用才能取到目标对象。

正确做法是：先检查是否还存活，再调用获取实例：

import weakref
<p>class Parent:
def <strong>init</strong>(self):
self.child = None</p><p>class Child:
def <strong>init</strong>(self, parent_ref):
self.parent_ref = parent_ref  # 存 weakref.ref，不是 parent 实例</p><p>parent = Parent()
parent.child = Child(weakref.ref(parent))</p><h1>使用时：</h1><p>if parent_ref := parent.child.parent_ref():
print(parent_ref.some_attr)  # ✅ 安全访问
else:
print("parent 已被回收")
</p>

永远别对 weakref.ref 对象做 obj.attr，只做 obj()
调用返回 None 表示原对象已被垃圾回收，必须判空
如果频繁访问，可以缓存调用结果（但注意生命周期）

weakref.WeakKeyDictionary 适合缓存但 key 必须是可哈希对象

想用弱引用做缓存映射（比如按实例缓存计算结果），WeakKeyDictionary 是更安全的选择——key 被回收后整条记录自动消失。但它只接受「可哈希」对象作 key，比如自定义类默认不可哈希，直接塞进去会报 TypeError: unhashable type。

常见错误场景：把普通实例当 key，没实现 __hash__ 和 __eq__：

import weakref
<p>cache = weakref.WeakKeyDictionary()</p><p>class Node:
def <strong>init</strong>(self, value):
self.value = value</p><h1>❌ 缺少 <strong>hash</strong>，下面这行会失败</h1><pre class="brush:php;toolbar:false;"># def __hash__(self): return id(self)

node = Node(42) cache[node] = "computed_result" # TypeError!

若要用实例作 key，必须显式定义 __hash__（通常返回 id(self)）和 __eq__
WeakKeyDictionary 的 value 不受弱引用保护，value 仍可能造成强引用链，需自行确保 value 不反向引用 key
它不支持 dict 的所有方法，比如没有 .keys() 的实时快照，迭代时 key 可能中途失效

循环引用在闭包或回调里最隐蔽，weakref.proxy 有风险

用 weakref.proxy 看似方便（支持直接点号访问），但它会在访问时抛出 ReferenceError 而不是返回 None，一旦没包住就崩。尤其在事件回调、定时器、装饰器中，容易漏掉异常处理。

提示词大师-python版

图片提示词生成器？不止如此。马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。输入「新手指南」查看完整功能介绍

下载

例如给某个对象注册回调，回调里又持有该对象的 proxy：

def on_timeout(proxy_obj):
    try:
        proxy_obj.do_something()  # ❌ 可能突然抛 ReferenceError
    except ReferenceError:
        pass  # 必须显式捕获
<p>obj = SomeClass()
proxy = weakref.proxy(obj)
timer.set_callback(lambda: on_timeout(proxy))
</p>