带参数装饰器的本质是“三层函数嵌套”
Python中带参数的装饰器不是直接修饰目标函数，而是先接收装饰器自身的参数，再返回一个真正的装饰器（即不带参数的装饰器）。这导致整个结构必须有三层函数：最外层接收装饰器参数，中间层接收被装饰函数，最内层是实际执行逻辑的包装函数。
三层结构逐层作用说明
以 @log(level='INFO') 为例：
-
第一层（最外）：
log(level='INFO')被调用，返回第二层函数（即真正的装饰器），此时level已绑定到闭包中； -
第二层（中间）：接收被装饰的函数（如
def func(): ...），返回第三层函数（即包装器）； -
第三层（最内）：接收调用时的参数（
*args, **kwargs），执行日志打印 + 原函数调用，是最终运行的 callable。
典型实现代码与关键细节
正确写法需用 @functools.wraps(func) 保持原函数元信息：
from functools import wraps
<p>def log(level='INFO'):
def decorator(func): # ← 第二层：真正装饰器
@wraps(func)
def wrapper(*args, *<em>kwargs): # ← 第三层：运行时包装器
print(f'[{level}] Calling {func.<strong>name</strong>}')
return func(</em>args, **kwargs)
return wrapper
return decorator # ← 第一层返回装饰器</p>使用时：@log('DEBUG') 先执行 log('DEBUG') 得到 decorator，再用它去装饰函数。
立即学习“Python免费学习笔记（深入）”；
常见错误与避坑提示
- 漏掉某一层
return（比如第一层没返回decorator，或第二层没返回wrapper），会导致语法错误或装饰失效； - 忘记用
@wraps，会使被装饰函数的__name__、__doc__变成wrapper的，影响调试和文档生成； - 误把参数传给第二层（如写成
def decorator(func, level='INFO')），这是错的——装饰器调用语法不支持向第二层传参，参数必须由第一层捕获并闭包传递。
