该用weakref当且仅当你持有对象但不想阻止其被垃圾回收。它适用于缓存、观察者模式、对象池等场景，通过弱引用避免循环引用和内存泄漏，常用类型包括weakref.ref、WeakKeyDictionary、WeakValueDictionary和finalize。
Python的
模块用于创建弱引用，避免循环引用导致的对象无法被垃圾回收，从而节省内存。它不增加对象的引用计数，因此当原对象被销毁时，弱引用自动失效（变为
或触发回调），特别适合缓存、观察者模式、对象池等场景。
什么时候该用weakref？
核心判断标准：你持有某个对象，但**不想阻止它被回收**。
实现缓存时，不希望缓存项长期驻留内存（如
）
对象A保存对对象B的引用，而B也反向引用A，形成循环——用弱引用打破其中一端
注册回调监听对象生命周期（如对象销毁前清理资源），用
GUI或事件系统中，避免控件被销毁后监听器仍强持有它，造成内存泄漏
常用弱引用类型与写法
最常用的是
和基于它的容器类，它们行为明确、开销小。
：返回一个可调用对象，调用后得到原对象（若还存在），否则返回
：键是弱引用，键对象被回收后，对应条目自动删除
：值是弱引用，值对象被回收后，条目自动清除
：在
被销毁前执行
，适合资源清理
示例：
立即学习
“
Python免费学习笔记（深入）
”；
实战：用WeakValueDictionary做安全缓存
相比普通字典，它能自动清理已销毁的对象，避免“幽灵缓存”。
Python 3.14.3
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
下载
适用场景：按ID缓存临时生成的对象（如数据库记录代理、图像处理中间结果）
不适用场景：需要长期稳定存在的配置对象、单例、全局状态
注意：键必须是不可变类型（如
、
），值必须支持弱引用（不能是list、dict、int等内置不可弱引用类型）
示例：
立即学习
“
Python免费学习笔记（深入）
”；
容易踩的坑
弱引用不是万能的，用错反而引入隐性bug。
内置类型不能被弱引用
：
、
、
、
等默认不支持
，尝试创建弱引用会报
弱引用本身不阻止回收，但你要确保它没被意外强持有
：比如把
存进全局列表，就又变成强引用了
多线程下需注意竞态
：判断
和后续使用之间，对象可能已被回收；建议用
捕获
finalize回调不保证执行时机
：它依赖
垃圾回收器
运行，在程序退出时可能不触发，不适合关键资源释放（应配合
或显式close）
不复杂但容易忽略。
weakrefNoneweakref.WeakValueDictionaryweakref.finalizeweakref.refweakref.ref(obj)Noneweakref.WeakKeyDictionary()weakref.WeakValueDictionary()weakref.finalize(obj, callback, *args)objcallbackimport 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（对象已销毁）
intstrcache = 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] 已自动移除（下一次访问会重建）
intstrlistdict__weakref__TypeErrorrefwref() is not Nonetry/except ReferenceError__del__