基础范式01
标准双层结构
外层接收原函数 func,内层 wrapper 接收任意参数并透传。
def deco(func):
def wrapper(*a, **kw):
return func(*a, **kw)
进阶传参02
带参三层嵌套
若装饰器本身需传参,须在外层再包一层工厂函数返回装饰器。
@retry(times=3)
def fetch(): ...
# 三层函数闭包嵌套
生产规范03
元数据保真
未加 wraps 时原函数名会变成 wrapper,破坏文档与调试。
from functools import wraps
@wraps(func)
def wrapper(*a, **kw):
核心口诀:装饰器 = 高阶函数 + 闭包 + @语法糖;工程编写务必搭配 @functools.wraps 保留原函数签名。