本文详解 Python 中装饰实例方法时的绑定机制与属性访问原理，通过缓存装饰器示例说明为何 method.cache 可读不可写，并提供安全重置装饰器状态的正确方式。
本文详解 python 中装饰实例方法时的绑定机制与属性访问原理，通过缓存装饰器示例说明为何 `method.cache` 可读不可写，并提供安全重置装饰器状态的正确方式。
在 Python 中，为类的实例方法应用装饰器（如 @cache）时，一个常见误区是认为装饰器会“绑定到每个实例”，从而让每个 instance.method 拥有独立的装饰器状态（例如 cache 属性）。但事实并非如此：装饰器在类定义阶段执行，作用于未绑定的方法对象（即 Power.of），其返回的包装函数被直接赋值给类属性 Power.of，而非实例属性。
这意味着所有实例共享同一个装饰后的方法对象——它本质上是一个函数（function），而非绑定方法（bound method）本身。当你调用 cube.of(2) 时，Python 首先通过描述符协议将 Power.of 绑定为 cube 的方法，生成一个临时的 bound method 对象；而该对象底层仍指向原始的 wrapper 函数，其 __func__ 就是 Power.of 所引用的装饰后函数。因此，wrapper.cache 是定义在函数对象上的属性，属于 Power.of 这个函数，而非 cube.of 这个绑定方法。
这就是为什么你能读取 cube.of.cache（Python 会沿 __func__ 向上查找 cache 属性），却无法赋值：
cube.of.cache = None # ❌ AttributeError: 'method' object has no attribute 'cache'
因为 cube.of 是一个 method 实例，它不支持动态设置任意属性（其 __dict__ 不可写），且 cache 并非它的原生属性——它是其 __func__（即 Power.of）的属性。
立即学习“Python免费学习笔记（深入）”；
✅ 正确做法是直接操作类上的装饰器函数：
import functools
def cache(func):
@functools.wraps(func)
def wrapper(*args, **kwargs):
if not hasattr(wrapper, 'cache') or wrapper.cache is None:
print("caching...")
wrapper.cache = func(*args, **kwargs)
return wrapper.cache
wrapper.cache = None
return wrapper
class Power:
def __init__(self, exponent):
self.exponent = exponent
@cache
def of(self, base):
return base ** self.exponent
# 使用示例
cube = Power(3)
print(cube.of(2)) # caching... → 8
print(cube.of(2)) # 8（命中缓存）
print(Power.of.cache) # 8
# ✅ 安全重置缓存：修改类属性，影响所有实例
Power.of.cache = None
print(cube.of(2)) # caching... → 8（重新计算）
# ✅ 也可为不同实例单独管理缓存（进阶方案）
# 若需实例级缓存，请改用 `functools.cached_property` 或在实例中维护状态⚠️ 注意事项：
- 装饰器状态（如 cache）默认是类级别共享的，不区分实例。若需实例隔离，请改用 self._cache 或 functools.cached_property（适用于无参属性计算）；
- 使用 functools.wraps 是良好实践，确保 __name__、__doc__ 等元信息正确继承；
- wrapper.cache = None 初始化必须在闭包外显式声明，否则首次调用前 hasattr(wrapper, 'cache') 会返回 False，导致逻辑异常；
- 避免依赖 method 对象的属性写入——它只是函数的绑定视图，状态应始终操作其底层函数（method.__func__）或类属性。
总结：理解 Python 方法调用链（instance.method → bound method → unbound function → wrapper）是掌握装饰器行为的关键。装饰实例方法，实质是装饰类中的函数对象；所有状态操作都应回归到该函数本身，而非其绑定结果。
