Python弱引用教程_weakref内存优化实践_技术教程

该用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，适合资源清理

示例：

import weakref
class 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等内置不可弱引用类型）

示例：

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）