装饰器本质是函数式组合的语法糖，即@decorator等价于func = decorator(func)，其核心是返回兼容原函数签名的新函数，并需用@wraps保留元信息以支持类型检查与IDE推导。
装饰器本质是函数式组合的语法糖
Python 装饰器不是魔法，它只是把 func = decorator(func) 这种显式函数包装，用 @decorator 语法糖重写了一遍。真正起作用的，是装饰器返回的新函数——这个新函数通常内部调用原函数，并在其前后插入逻辑。这和函数式编程里的组合（compose(f, g) 表示先 g 再 f）在语义上完全一致。
关键在于：所有装饰器都必须返回一个可调用对象，且该对象参数签名需兼容原函数（否则调用会出错）。常见错误是装饰器内部没正确传递 *args 和 **kwargs，导致被装饰函数接收不到参数。
- 用
functools.wraps(func)包裹内层函数，避免丢失原函数的__name__、__doc__等元信息 - 不带参数的装饰器：返回一个接受函数的闭包；带参数的装饰器：返回一个“装饰器工厂”，即返回一个闭包，该闭包再返回真正的装饰器
- 多个装饰器叠加（
@a\n@b\ndef f()）等价于f = a(b(f))，注意执行顺序是从下往上、组合方向是右到左
手动实现 compose 辅助多装饰器链式组合
当需要动态组合多个装饰器（比如根据配置开关日志、缓存、权限），硬写 @log @cache @auth 不够灵活。此时可自己写一个 compose 函数，把装饰器当作一元函数来组合：
def compose(*funcs):
def inner(x):
for f in reversed(funcs):
x = f(x)
return x
return inner
<h1>等价于 @timer @validate @retry</h1><p>wrapped = compose(timer, validate, retry)(my_func)
注意 reversed：因为 compose(f, g) 本意是 f(g(x))，而装饰器链 @f @g def h() 实际是 f(g(h))，所以组合时要倒序遍历。
立即学习“Python免费学习笔记（深入）”；
- 这种写法绕过了语法糖限制，适合运行时决定装饰顺序或条件组合
- 每个装饰器仍需保持“接收函数 → 返回函数”的签名，否则
compose无法串联 - 调试时直接打印
wrapped.__name__可能显示inner，务必在每个装饰器里用@wraps
@wraps 不只是修元信息，更是避免类型检查/IDE 推导失败
很多开发者只把 @wraps 当作让 help() 显示正确文档的补救措施，但它对静态分析工具（如 mypy、PyCharm）同样关键。没有 @wraps，装饰后的函数类型会被识别为 Any 或闭包类型，导致参数提示丢失、类型校验失效。
典型表现：my_func(123) 在 IDE 里没有参数提示，mypy 报 error: "Callable[..., Any]" has no attribute "__name__"。
- 必须在装饰器内部的包装函数上加
@wraps(func)，而不是在装饰器函数本身 - 如果装饰器有参数（如
@retry(max_attempts=3)），@wraps要放在最内层返回的函数上 - 第三方装饰器库（如
tenacity、backoff）多数已内置@wraps，但自定义时极易遗漏
装饰器 + partial 实现参数预绑定的组合场景
当某个装饰器需要固定部分参数（比如 @cache(ttl=300)），又想把它和其他装饰器组合使用时，直接传 cache(ttl=300) 会立即执行并返回非函数对象。这时应改用 functools.partial 延迟求值：
from functools import partial <p>cached_5min = partial(cache, ttl=300) wrapped = compose(cached_5min, validate, log)(my_func)
这比写一个专门的 cache_5min 工厂函数更轻量，也避免了闭包嵌套过深。
-
partial返回的是可调用对象，满足装饰器组合链要求 - 不能对已经执行过的装饰器结果再
partial（如partial(cache(...)(func), ...)），那已经是最终函数了 - 和
lambda相比，partial更易读、可序列化、支持__repr__，适合生产环境
装饰器与函数式组合的边界其实很薄——只要你始终记得：装饰器是函数，返回值是函数，组合就是函数套函数。最容易被忽略的是签名一致性：哪怕逻辑再简单，漏传 *args 或忘了 @wraps，下游调用就会悄无声息地崩掉。
