该用weakref当且仅当你持有对象但不想阻止其被垃圾回收。它适用于缓存、观察者模式、对象池等场景,通过弱引用避免循环引用和内存泄漏,常用类型包括weakref.ref、WeakKeyDictionary、WeakValueDictionary和finalize。

Python的weakref模块用于创建弱引用,避免循环引用导致的对象无法被垃圾回收,从而节省内存。它不增加对象的引用计数,因此当原对象被销毁时,弱引用自动失效(变为None或触发回调),特别适合缓存、观察者模式、对象池等场景。
什么时候该用weakref?
核心判断标准:你持有某个对象,但**不想阻止它被回收**。
- 实现缓存时,不希望缓存项长期驻留内存(如
weakref.WeakValueDictionary) - 对象A保存对对象B的引用,而B也反向引用A,形成循环——用弱引用打破其中一端
- 注册回调监听对象生命周期(如对象销毁前清理资源),用
weakref.finalize - GUI或事件系统中,避免控件被销毁后监听器仍强持有它,造成内存泄漏
常用弱引用类型与写法
最常用的是weakref.ref和基于它的容器类,它们行为明确、开销小。
-
weakref.ref(obj):返回一个可调用对象,调用后得到原对象(若还存在),否则返回None -
weakref.WeakKeyDictionary():键是弱引用,键对象被回收后,对应条目自动删除 -
weakref.WeakValueDictionary():值是弱引用,值对象被回收后,条目自动清除 -
weakref.finalize(obj, callback, *args):在obj被销毁前执行callback,适合资源清理
示例:
立即学习“Python免费学习笔记(深入)”;
import weakrefclass Data: def init(self, name): self.name = name def del(self): print(f"{self.name} 被销毁")
obj = Data("cache_item") wref = weakref.ref(obj) print(wref()) # 输出: <main.Data object at 0x...> del obj print(wref()) # 输出: None(对象已销毁)
实战:用WeakValueDictionary做安全缓存
相比普通字典,它能自动清理已销毁的对象,避免“幽灵缓存”。
- 适用场景:按ID缓存临时生成的对象(如数据库记录代理、图像处理中间结果)
- 不适用场景:需要长期稳定存在的配置对象、单例、全局状态
- 注意:键必须是不可变类型(如
int、str),值必须支持弱引用(不能是list、dict、int等内置不可弱引用类型)
示例:
立即学习“Python免费学习笔记(深入)”;
cache = weakref.WeakValueDictionary()def getdata(id): if id not in cache: cache[id] = Data(f"item{id}") # 值被弱引用 return cache[id]
a = get_data(100) print(100 in cache) # True del a
此时cache[100] 已自动移除(下一次访问会重建)
容易踩的坑
弱引用不是万能的,用错反而引入隐性bug。
-
内置类型不能被弱引用:
int、str、list、dict等默认不支持__weakref__,尝试创建弱引用会报TypeError -
弱引用本身不阻止回收,但你要确保它没被意外强持有:比如把
ref存进全局列表,就又变成强引用了 -
多线程下需注意竞态:判断
wref() is not None和后续使用之间,对象可能已被回收;建议用try/except ReferenceError捕获 -
finalize回调不保证执行时机:它依赖垃圾回收器运行,在程序退出时可能不触发,不适合关键资源释放(应配合
__del__或显式close)
不复杂但容易忽略。










