weakref能解决父子类、观察者模式及缓存容器中的循环引用问题，通过弱引用不增加引用计数的特性，使GC可及时回收仅剩弱引用的对象；weakref.ref适用于单对象弱引用，WeakKeyDictionary适用于以对象为键的映射。
weakref能解决什么循环引用问题
Python的垃圾回收器（GC）对循环引用的处理有天然限制：当两个或多个对象仅通过彼此的强引用维系关系，且外部再无其他引用时，CPython的引用计数机制无法释放它们，只能依赖周期性运行的GC来清理。但GC不是实时的，尤其在长期运行的服务中，这类未及时回收的对象会持续占用内存。典型场景包括：
- 父子类结构中，父对象保存子对象列表，子对象又通过
parent属性反向持有父对象 - 观察者模式里，被观察对象持有一组观察者，观察者又持有被观察对象的引用
- 缓存容器（如
dict）存储对象，同时对象内部又引用该缓存
这些情况下，weakref提供一种“不参与引用计数”的引用方式，让GC可以安全地回收目标对象。
用weakref.ref还是weakref.WeakKeyDictionary
选哪个取决于你的使用模式：
- 用
weakref.ref当你只需要单个弱引用，并且愿意手动调用它来获取原始对象（它本身是可调用对象）：import weakref
class Parent: def init(self): self.children = []
class Child: def init(self, parent): self._parent_ref = weakref.ref(parent) # 不增加parent的引用计数
@property
def parent(self):
return self._parent_ref() # 调用ref对象取值，可能为None
p = Parent() c = Child(p) p.children.append(c)
del p # 此时Parent实例可被立即回收（只要没有其他强引用） print(c.parent) # 输出 None
- 用
weakref.WeakKeyDictionary当你需要类似<code>dict的映射结构，且键对象生命周期应独立于字典存在（例如缓存、事件监听表）：import weakref
键是对象实例，值是回调函数
listeners = weakref.WeakKeyDictionary()
class Button: pass
btn = Button() listeners[btn] = lambda: print("clicked")
del btn # Button实例被回收，listeners自动丢弃对应条目 print(len(listeners)) # 输出 0
注意：WeakKeyDictionary只对键弱引用，值仍是强引用；若需对值也弱引用，得用weakref.WeakValueDictionary。
容易忽略的陷阱：lambda和闭包里的强引用
这是最常踩的坑——你以为用了weakref就安全了，结果闭包悄悄保留了强引用：
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
parent
赋给weakref.ref，这个lambda仍阻止parent被回收。
正确做法是只在需要时通过弱引用来访问：
ref
-
functools.lru_cache默认对参数做弱引用（需传typed=False且参数是可哈希对象），但要注意它缓存的是返回值，不是对象本身 -
logging.Logger内部用weakref.WeakValueDictionary管理handler，避免logger和handler互相强引用 - 第三方库如
traitlets、PyQt的信号槽机制普遍依赖weakref管理回调生命周期
所以不必所有地方都手写weakref.ref，先确认你用的库是否已处理。真正要动手的，往往是自定义父子关系、观察者注册、或实现带对象生命周期感知的缓存逻辑。
弱引用不是银弹：它让对象可被回收，但也意味着你必须频繁检查ref()是否返回None；在高并发场景下，两次检查之间对象可能已被回收，这种竞态虽小但真实存在。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
