weakref仅在双向引用且需避免父对象因子对象存活而无法回收时使用；单向引用、临时对象或生命周期一致的组合不应使用，否则增加理解成本和空引用风险。

weakref 什么时候该用，什么时候不该用

当对象之间存在双向引用（比如父容器持子对象引用，子对象又通过 parent 属性反向持有父引用），且你明确不希望父对象因子对象存活而无法被回收时，weakref 才是合理选择。它不是通用“防泄漏”工具——对单向引用、临时对象、或生命周期天然一致的组合，强行加 weakref 反而增加理解成本和空引用风险。

用 weakref.ref 还是 weakref.WeakKeyDictionary？

取决于引用关系类型：

• 单个对象需弱引用：用 weakref.ref，调用后返回可调用对象，必须先检查是否还活着再解引用：

  parent_ref = weakref.ref(parent)
  if parent_ref() is not None:
      parent_ref().do_something()

• 多个子对象共用一个父对象，且父对象作字典 key：用 weakref.WeakKeyDictionary，key 被回收后自动剔除条目，避免手动清理；但 value 仍是强引用，别误以为 value 也会被弱化
• 需要以子对象为 key、父对象为 value：用 weakref.WeakValueDictionary，value 被回收时条目自动消失

常见踩坑：回调函数里直接捕获强引用

注册回调（如信号、事件监听）时，若在 lambda 或闭包中直接引用了 self 或其他长生命周期对象，即使外部用了 weakref，闭包仍会制造隐式强引用链。正确做法是回调内只存弱引用并显式判空：

def make_callback(obj):
    obj_ref = weakref.ref(obj)
    def callback():
        o = obj_ref()
        if o is not None:
            o.handle_event()
    return callback
错误示例（强引用逃逸）：
lambda: self.on_event()  ← self 被闭包强持有

替代方案比 weakref 更简单的情况

不是所有循环引用都需要 weakref：

• 使用 __slots__ 减少实例字典开销，配合明确的 del 或置 None 清理（如树节点的 parent 字段设为 None）
• 用上下文管理器（__enter__/__exit__）控制生命周期，避免跨作用域持有
• Python 3.4+ 的 gc.collect() 能处理大多数可达循环（仅含容器对象），无需干预；只有涉及 __del__ 或 C 扩展时，才真正需要弱引用破环

真正难处理的是那些混入了自定义 __del__、或嵌套了 C API 对象的循环——这时 weakref 不是银弹，得配合 gc 调试工具定位哪一环没断开。