weakref.ref不能直接当对象用，因其返回的是可调用弱引用对象而非原始实例，直接使用会报TypeError；正确做法是每次通过ref()取值并判空，适用于子持父等需避免循环引用的场景。
weakref.ref 为什么不能直接当对象用？
直接调用 weakref.ref 返回的是一个可调用对象，不是原始实例本身。常见错误是把它当成原对象传给函数或赋值给属性，结果运行时报 TypeError: 'weakref' object is not callable 或后续访问失败。
- 正确做法：每次使用前必须显式调用它，比如
obj_ref()，且要检查返回值是否为None（目标已被回收） - 典型场景：在回调、观察者模式中保存对“持有者”的弱引用，避免监听器阻止持有者被释放
- 别写
self.parent = weakref.ref(parent)然后直接用self.parent.do_something()—— 这会崩
weakref.WeakKeyDictionary 适合做缓存但不支持不可哈希类型
它内部用键的 identity 做弱引用管理，键被销毁时对应条目自动清理。但只接受可哈希对象（如类实例、字符串、数字），dict、list、自定义未实现 __hash__ 的类实例都会触发 TypeError: unhashable type。
- 适用场景：按实例缓存计算结果，比如
cache[instance] = expensive_result，实例销毁后缓存自动失效 - 注意
WeakKeyDictionary的键是弱引用，值是强引用 —— 如果值又反向引用了键，照样构成循环引用 - 若需弱引用值，得组合
WeakValueDictionary，但它的键是强引用，得看业务逻辑哪边更该“让步”
__del__ 和 weakref.callback 不要混用
注册 weakref.ref(obj, callback) 后，callback 在 obj 被垃圾回收时触发；而 __del__ 方法在实例即将销毁时调用。两者都可能执行，但顺序不确定，且 __del__ 本身容易引发问题（比如引用其他正在销毁的对象）。
- 优先用
weakref.ref+ callback，它更可控、无副作用，也不依赖 GC 时机 - 避免在 callback 里再创建新强引用指向原对象（比如存进全局 list），否则对象无法真正释放
-
__del__里不要调用涉及循环引用链上其他对象的方法 —— 它们可能已处于部分销毁状态，导致AttributeError或静默失败
asyncio 里 weakref 要小心事件循环生命周期
在异步代码中，如果用 weakref.ref 持有协程函数或 task 对象，要注意这些对象的生命周期由事件循环管理。task 被 cancel 或完成之后，即使没显式 await，也可能很快被回收，导致弱引用提前失效。
- 典型坑：注册
weakref.ref(task, lambda r: print("done"))，但 task 已结束、回调还没触发，r()就返回None - 更稳妥的做法是用
asyncio.create_task启动一个清理协程，在 task 完成后手动触发逻辑，而不是依赖弱引用回调 - 弱引用对
asyncio.Future有效，但对普通生成器或async def函数对象无效 —— 它们不是“可被弱引用的实例”
弱引用不是银弹。它解决的是“谁该决定生命周期”的问题，而不是自动打破所有引用。关键在于理清对象图里哪一端该主动释放，然后用 weakref 把那一端变成被动方。稍不注意，callback 里一行强引用、缓存里一个反向指针，就又绕回去了。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
