weakref用于避免循环引用导致的内存泄漏，支持WeakValueDictionary、WeakKeyDictionary、WeakSet及weakref.ref等，适用于缓存、观察者模式、父子结构解耦及资源自动清理。
weakref（弱引用）在 Python 中主要用于避免循环引用导致的内存泄漏，尤其在缓存、观察者模式、对象池等场景中非常关键。它不增加被引用对象的引用计数，因此不会阻止垃圾回收器回收对象。
缓存场景：避免缓存占用过多内存
当实现一个对象级缓存（如按 ID 缓存实例）时，若用普通字典存储，即使原始对象已无其他引用，缓存仍会持有它，造成内存无法释放。weakref.WeakValueDictionary 可自动剔除已被回收的对象。
例如：
- 用 WeakValueDictionary 存储模型实例，键为 ID，值为对象本身；对象被显式 del 或离开作用域后，缓存项自动消失
- 搭配 weakref.WeakKeyDictionary 实现“以对象为键”的映射（如元数据绑定），避免因字典持键而延长对象生命周期
观察者/事件系统：防止监听器意外驻留
在发布-订阅或回调注册机制中，若被观察对象长期存在，而观察者是短生命周期对象（如 GUI 控件、临时处理器），普通引用会导致观察者无法被回收。
立即学习“Python免费学习笔记（深入）”；
建议做法：
- 用 weakref.ref 包装回调函数或观察者实例，在触发前先调用 ref() 检查是否仍有效
- 使用 weakref.WeakSet 管理监听器集合，添加时自动弱引用，对象销毁后自动清理
树形或图结构中的父子引用
当父节点持有子节点强引用、子节点又反向持有父节点强引用（如 AST 节点、DOM 元素、ORM 关系对象），就会形成循环引用。CPython 的引用计数无法释放它们，依赖周期性 GC，但延迟不可控。
解决方式：
- 子节点对父节点使用 weakref.ref，访问父节点时通过 parent_ref() 获取（可能为 None）
- 避免在 __del__ 中依赖弱引用目标——因为弱引用回调和对象析构顺序不确定
自定义资源管理与调试辅助
weakref 还支持注册回调函数（weakref.finalize），在对象被销毁时执行清理逻辑，比 __del__ 更可靠（不参与循环引用判断，且明确分离资源释放时机）。
典型用途：
- 追踪对象生命周期，用于内存泄漏排查（配合 weakref.WeakSet 记录活跃实例）
- 释放外部资源（如 C 库句柄、临时文件句柄），无需用户显式 close，由 finalize 保障
- 注意：finalize 回调不接收 self，只能访问闭包变量或外部状态
weakref 不是万能的，它不能用于不可哈希或不可弱引用的类型（如 int、str、tuple 等内置不可变类型默认不支持弱引用，除非自定义 __weakref__）。合理使用的关键在于明确“谁该决定生命周期”，把控制权交给真正拥有所有权的一方。
