用weakref实现图像纹理lru缓存的关键是弱持有+强管理：weakvaluedictionary存weakref、双向链表维护访问序、finalizationregistry在对象回收时同步清理元数据，三者协同缺一不可。
用 WeakRef 实现“用完即丢”的图像纹理 LRU 缓存，关键不在单纯用 WeakRef，而在于**把 WeakRef 作为值容器，再叠加显式的 LRU 排序逻辑和 GC 协同清理机制**。否则，仅靠弱引用会导致缓存项残留、查找变慢、内存不及时释放——这正是你提到的“newValue 很快被 GC，但 cache 里仍存着已空 WeakRef”的问题。
核心结构：WeakValueDictionary + 双向链表 + FinalizationRegistry
这不是一个纯弱引用缓存，而是“弱持有 + 强管理”的混合设计：
- WeakValueDictionary 存储 key → WeakRef(value)，保证图像对象无外部强引用时可被 GC
- 双向链表（或 OrderedDict） 维护访问顺序，支持 O(1) 移动到头、O(1) 删除尾部最久未用项
- FinalizationRegistry 在图像对象真正被回收时，立即从链表和字典中清除对应 key（避免 dangling WeakRef）
注册键必须是不可变且可严格比较的值
FinalizationRegistry 的注册键不能是图像对象本身，也不能是普通 dict/list。推荐用：
- 纹理路径字符串（如
"assets/hero_idle.png"） - 哈希值（如
sha256(b"raw_data").hexdigest()[:16]） - Symbol（若在支持环境）
错误示例：registry.register(texture_obj, cleanup, texture_obj) —— 对象本身作键会导致无法清理，且 GC 后键失效。
缓存 get/set 的安全流程
每次访问都需检查 WeakRef 是否还有效，并更新 LRU 顺序：
-
get(key)：查
weak_dict.get(key)→ 若ref.deref()不为 None，则将其节点移到链表头部，返回图像；否则返回 None 或触发重载 -
set(key, image)：先调用
registry.register(image, cleanup_fn, key)，再存入weak_dict[key] = WeakRef(image)，同时插入链表头部；若超限，删链表尾部 key 并从weak_dict中 pop（此时 registry 已确保该 key 的 cleanup 会被触发）
cleanup_fn 必须只做外部副作用
清理函数里不能访问 image 对象（它已被回收），只能操作缓存元数据：
- 从链表中移除对应节点（需提前在节点里存好 key）
- 从
weak_dict中pop(key, None) - （可选）记录日志或指标，如
stats['evicted_by_gc'] += 1
注意：注册必须在 WeakRef(image) 创建后立即完成，且传入的 key 必须与后续字典 key 完全一致。
不复杂但容易忽略：WeakRef 本身不解决淘汰顺序，FinalizationRegistry 不负责排序——这两者必须和 LRU 结构协同，缺一不可。
