必须用weakref的场景是当对象间存在互相强引用且无外部引用维持存活时，如观察者回调、树节点双向引用、缓存键值互持；使用时须判空弱引用、避免闭包捕获、正确使用WeakKeyDictionary。
Python 的 weakref 能帮你绕过循环引用导致的垃圾回收失效，但直接套用 weakref.ref 或 weakref.WeakKeyDictionary 很容易踩坑——比如回调里访问已销毁对象抛 ReferenceError，或误用弱引用替代生命周期管理。
什么时候必须用 weakref？不是所有循环引用都需要它
只有当两个（或多个）对象互相持有强引用、且没有外部引用维持它们存活时，才真正构成 GC 无法处理的循环。典型场景是：观察者模式中回调绑定实例方法、树节点父子双向引用、缓存中键值互持。
- 类方法绑定后会隐式持有
self强引用，若观察者把回调存进被观察者，就形成循环 -
__del__不可靠，不能依赖它清理资源；weakref.finalize是更可控的替代 - 单纯用
del或设为None可能漏掉间接引用，weakref 是声明式解耦
用 weakref.ref 包裹回调，但必须检查是否还活着
直接调用弱引用对象不安全，它可能已回收。必须先调用返回的引用对象，判空再执行逻辑。
import weakref
<p>class Observer:
def <strong>init</strong>(self, subject):</p><h1>存弱引用，避免 subject 持有 observer 强引用</h1><pre class='brush:python;toolbar:false;'> self.callback = weakref.ref(self.on_update)
subject.add_observer(self.callback)
def on_update(self):
print("updated")在 subject 内部触发时：
def notify_observers(self): for ref in self.observers: cb = ref() # 调用 ref() 得到原函数，可能为 None if cb is not None: cb()
- 不要写
ref()后直接调用，必须判空——否则抛ReferenceError - 绑定实例方法时，
weakref.ref(obj.method)实际弱引用的是绑定方法对象，不是obj本身；若需保活obj，应弱引用obj并在回调里手动取方法 -
lambda或闭包会捕获变量，可能意外延长对象生命周期，慎用
用 weakref.WeakKeyDictionary 管理反向映射，但别当普通 dict 用
它只对 key 做弱引用，value 仍是强引用。适合“以对象为键、存元数据”的场景，比如给每个实例附加调试信息。
提示词大师-python版
下载
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
立即学习“Python免费学习笔记（深入）”；
import weakref <h1>正确：key 是实例，value 是轻量数据</h1><p>_debug_info = weakref.WeakKeyDictionary()</p><p>def attach_debug(obj, info): _debug_info[obj] = info # obj 销毁后，该条目自动消失</p><h1>错误：value 是另一个长生命周期对象，会导致 obj 无法回收</h1><h1>_debug_info[obj] = big_cache_object # big_cache_object 持有 obj 强引用？</h1>
- value 不能反过来引用 key，否则弱引用失效——WeakKeyDictionary 只管 key 的生命周期
- 遍历
dict.keys()时，某些 key 可能在迭代中途被回收，引发RuntimeError；应先转成 list：list(d.keys()) - 不支持
dict.setdefault()这类原子操作，需手动检查+赋值
最常被忽略的点是：weakref 解决的是引用计数归零前的循环阻塞，但它不改变对象本身的销毁时机。如果对象被全局变量、闭包、线程局部存储等意外持有，weakref 也救不了——得先确认泄漏源真正在 weakref 覆盖范围内。
