为Python具名元组（NamedTuple）实现缓存属性的最优方案探讨

问题根源 #

标准库functools.cached_property无法直接用于NamedTuple：

• NamedTuple实例没有__dict__，无法存储缓存值；
• 类定义流程的特殊性导致cached_property的__set_name__方法无法自动触发，引发报错。

符合要求的实现方案 #

我们可以自定义一个基于弱引用的缓存装饰器，既满足延迟计算、缓存需求，又不会造成内存泄漏，同时保证缓存属性不成为NamedTuple的真实字段。

自定义缓存装饰器

import weakref
from collections import namedtuple

class cached_namedtuple_property:
    def __init__(self, func):
        self.func = func
        # 用弱引用字典存储缓存，实例销毁时自动清理对应条目
        self.cache = weakref.WeakKeyDictionary()

    def __get__(self, instance, owner):
        if instance is None:
            return self
        # 首次访问时计算并缓存，后续直接返回缓存值
        if instance not in self.cache:
            self.cache[instance] = self.func(instance)
        return self.cache[instance]

应用到NamedTuple

有两种使用方式，效果一致：

方式1：动态添加属性

# 定义基础NamedTuple
Rectangle = namedtuple('Rectangle', ['width', 'height'])
# 添加缓存属性area
Rectangle.area = cached_namedtuple_property(lambda self: self.width * self.height)

方式2：继承NamedTuple的类

class Rectangle(namedtuple('Rectangle', ['width', 'height'])):
    @cached_namedtuple_property
    def area(self):
        # 这里可以添加计算逻辑，示例为宽高乘积
        print("正在计算面积...")
        return self.width * self.height

验证效果

# 创建实例
rect = Rectangle(3, 4)

# 首次访问：执行计算并缓存
print(rect.area)  # 输出：正在计算面积... 12
# 二次访问：直接返回缓存值，不再计算
print(rect.area)  # 输出：12

# 验证缓存属性不是真实字段
width, height = rect  # 正常解构，仅获取定义的字段
# width, height, area = rect  # 执行会抛出ValueError，说明area不是字段

方案满足的要求 #

1. 非真实字段：NamedTuple的字段仅为定义时声明的width和height，area是动态添加的属性，无法通过解构获取；
2. 延迟计算+缓存：首次访问area时执行计算逻辑，后续访问直接返回缓存结果；
3. 无内存泄漏：使用weakref.WeakKeyDictionary存储缓存，当实例被销毁（无引用时），对应的缓存条目会被自动清理，不会持有实例的强引用。

内容的提问来源于stack exchange，提问作者COVFEFE-19