weakref能解决父子类、观察者模式及缓存容器中的循环引用问题，通过弱引用不增加引用计数的特性，使GC可及时回收仅剩弱引用的对象；weakref.ref适用于单对象弱引用，WeakKeyDictionary适用于以对象为键的映射。

weakref能解决什么循环引用问题

Python的垃圾回收器（GC）对循环引用的处理有天然限制：当两个或多个对象仅通过彼此的强引用维系关系，且外部再无其他引用时，CPython的引用计数机制无法释放它们，只能依赖周期性运行的GC来清理。但GC不是实时的，尤其在长期运行的服务中，这类未及时回收的对象会持续占用内存。典型场景包括：

• 父子类结构中，父对象保存子对象列表，子对象又通过parent属性反向持有父对象
• 观察者模式里，被观察对象持有一组观察者，观察者又持有被观察对象的引用
• 缓存容器（如dict）存储对象，同时对象内部又引用该缓存

这些情况下，weakref提供一种“不参与引用计数”的引用方式，让GC可以安全地回收目标对象。

用weakref.ref还是weakref.WeakKeyDictionary

选哪个取决于你的使用模式：

• 用weakref.ref当你只需要单个弱引用，并且愿意手动调用它来获取原始对象（它本身是可调用对象）：

  import weakref
  </li></ul><p>class Parent:
  def <strong>init</strong>(self):
  self.children = []</p><p>class Child:
  def <strong>init</strong>(self, parent):
  self._parent_ref = weakref.ref(parent)  # 不增加parent的引用计数</p><pre class="brush:php;toolbar:false;">@property
  def parent(self):
      return self._parent_ref()  # 调用ref对象取值，可能为None

  p = Parent() c = Child(p) p.children.append(c)

  del p # 此时Parent实例可被立即回收（只要没有其他强引用） print(c.parent) # 输出 None

  • 用weakref.WeakKeyDictionary当你需要类似<code>dict的映射结构，且键对象生命周期应独立于字典存在（例如缓存、事件监听表）：

    import weakref
    </li></ul><h1>键是对象实例，值是回调函数</h1><p>listeners = weakref.WeakKeyDictionary()</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p><p>class Button:
    pass</p><p>btn = Button()
    listeners[btn] = lambda: print("clicked")</p><p>del btn  # Button实例被回收，listeners自动丢弃对应条目
    print(len(listeners))  # 输出 0</p>

    注意：WeakKeyDictionary只对键弱引用，值仍是强引用；若需对值也弱引用，得用weakref.WeakValueDictionary。

    容易忽略的陷阱：lambda和闭包里的强引用

    这是最常踩的坑——你以为用了weakref就安全了，结果闭包悄悄保留了强引用：

    

    python-script-generator

    快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。

    下载

    <pre class="brush:php;toolbar:false;"># ❌ 错误写法：lambda捕获了parent的强引用
    class Child:
        def __init__(self, parent):
            # 这里parent被lambda闭包捕获，引用计数+1
            self.callback = lambda: print(f"parent id: {id(parent)}")
    

    即使后续把parent赋给<code>weakref.ref，这个lambda仍阻止parent被回收。

    正确做法是只在需要时通过弱引用来访问：

    # ✅ 正确：callback里不持有强引用
    class Child:
        def __init__(self, parent):
            self._parent_ref = weakref.ref(parent)
    <pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">def callback(self):
        parent = self._parent_ref()
        if parent is not None:
            print(f"parent id: {id(parent)}")

    另一个常见错误是把弱引用对象直接存进列表或字典后，忘记它返回的是ref对象而非原对象，导致后续调用失败。

    是否必须显式调用weakref.ref()？

    不一定。很多标准库组件已内置弱引用支持，比如：

    • functools.lru_cache默认对参数做弱引用（需传typed=False且参数是可哈希对象），但要注意它缓存的是返回值，不是对象本身
    • logging.Logger内部用weakref.WeakValueDictionary管理handler，避免logger和handler互相强引用
    • 第三方库如traitlets、PyQt的信号槽机制普遍依赖weakref管理回调生命周期

    所以不必所有地方都手写weakref.ref，先确认你用的库是否已处理。真正要动手的，往往是自定义父子关系、观察者注册、或实现带对象生命周期感知的缓存逻辑。

    弱引用不是银弹：它让对象可被回收，但也意味着你必须频繁检查ref()是否返回None；在高并发场景下，两次检查之间对象可能已被回收，这种竞态虽小但真实存在。