类实现带状态的装饰器更可靠，因类实例天然独立持状态，而闭包易因共享自由变量导致错乱；必须实现__init__（存func、初始化静态状态）和__call__（处理动态行为），缺一不可。
为什么用类实现带状态的装饰器比闭包更可靠
因为类实例天然持有状态，而闭包依赖外部作用域变量，在多装饰器叠加、被装饰函数重定义或调试重载时，闭包容易共享同一份自由变量导致状态错乱。__call__ 方法让类实例可直接调用，语义清晰，且每个被装饰函数对应独立实例（只要正确实现 __init__ 和 __call__）。
类装饰器必须实现的两个方法
缺一不可：构造函数 __init__ 接收被装饰的函数，__call__ 实现实际逻辑并管理状态。漏掉 __call__ 会导致 TypeError: 'XXX' object is not callable；若在 __init__ 中没保存 self.func = func，后续无法调用原函数。
-
__init__(self, func)：只运行一次，适合初始化计数器、缓存字典等静态状态 -
__call__(self, *args, **kwargs)：每次调用被装饰函数时触发，适合更新调用次数、记录参数、条件拦截等动态行为 - 如果要支持带参数的装饰器（如
@count_calls(max_calls=5)），需再嵌套一层工厂类或函数，此时__init__改为接收配置，返回真正装饰器实例
常见状态误用：共享实例 vs 独立实例
错误写法是把装饰器类定义成单例或模块级全局实例，导致所有被装饰函数共用同一份状态。正确做法是确保每次 @MyDecorator 都新建一个类实例。
例如统计调用次数：
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
class CallCounter:
def __init__(self, func):
self.func = func
self.count = 0 # ✅ 每个被装饰函数有自己的 count
<pre class="brush:php;toolbar:false;">def __call__(self, *args, **kwargs):
self.count += 1
print(f"{self.func.__name__} called {self.count} times")
return self.func(*args, **kwargs)
@CallCounter def say_hello(): return "hello"
注意：say_hello.count 可直接访问，但若用 functools.wraps 包装原函数，需手动复制属性，否则 say_hello.__name__ 会变成 '__call__'。
性能与兼容性要注意的点
类装饰器本身有轻微实例化开销，但通常可忽略；真正影响性能的是状态操作本身（如频繁写磁盘、加锁、查数据库）。另外，某些框架（如 Flask 的 @app.route）内部依赖函数对象的特定属性，若类装饰器未保留 __name__、__doc__ 等，可能引发路由注册失败或文档生成异常。
- 用
functools.wraps(self.func)装饰__call__方法，或手动赋值self.__name__ = func.__name__等 - 避免在
__call__中做阻塞操作（如同步 HTTP 请求），尤其在异步环境里 - 线程不安全：多个线程同时调用同一被装饰函数时，
self.count += 1非原子操作，需用threading.Lock或atomic integer类型
状态不是越多越好，关键看是否真被后续逻辑依赖——比如只为了打日志而存参数列表，不如直接在 __call__ 里 print，别往实例里堆字段。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
