弱引用缓存通过WeakValueDictionary、WeakKeyDictionary和weakref.ref实现自动清理，避免阻碍对象回收；需确保类支持弱引用，即含__weakref__属性或未用__slots__限制。

用弱引用实现缓存清理，核心是让缓存不“拖住”对象——对象一旦失去其他强引用，就能被垃圾回收器立刻释放，缓存项随之自动失效。这不是靠定时扫描或手动淘汰，而是由 Python 的内存管理机制自然驱动。

用 WeakValueDictionary 构建自动清空的缓存

这是最直接的方式：值以弱引用方式存储，只要外部不再持有该对象，它就会从字典中消失。

• 初始化缓存时直接使用 weakref.WeakValueDictionary()，无需额外逻辑
• 插入时像普通字典一样赋值：cache[key] = obj，obj 会被自动转为弱引用
• 读取时调用 cache.get(key)，若 obj 已被回收，返回 None
• 无需写清理代码，也不用跟踪对象生命周期，GC 触发后字典自动收缩

用 WeakKeyDictionary 绑定元数据而不延长对象寿命

当需要以对象本身为键（比如给某个 GUI 控件加临时配置），普通字典会让控件无法被回收；WeakKeyDictionary 则不会。

• 键是弱引用，控件销毁后，对应键值对自动从字典中移除
• 适合做“附加工具映射”，例如：metadata_map[widget] = {"last_click": time.time()}
• 即使 widget 被 del 或离开作用域，metadata_map 不会阻止它被回收

配合 weakref.ref 实现带状态检查的回调缓存

在事件系统或观察者模式中，缓存的是回调函数或处理器实例，但又不能让它们长期驻留内存。

• 用 weakref.ref(handler) 存储回调，而不是直接存 handler 本身
• 每次触发前先调用 ref()，返回 None 表示 handler 已销毁，跳过执行
• 可搭配 weakref.finalize(obj, callback) 在对象销毁时清理关联资源

注意类是否支持弱引用

不是所有对象默认能被弱引用。关键看类是否允许生成 __weakref__ 属性。

• 普通类（没定义 __slots__）天然支持弱引用
• 若用了 __slots__，必须显式包含 __weakref__：__slots__ = ('x', 'y', '__weakref__')
• 内置类型如 list、dict、int 等不支持弱引用，只能包装成自定义类实例再缓存