不带参数的装饰器是接收函数并返回新函数的单层包装，如def log_calls(func):...return wrapper；必须用@log_calls而非@log_calls()，否则报错。
不带参数的装饰器长什么样
不带参数的装饰器接收一个函数作为唯一参数，返回一个新的函数。它本质是「函数 → 函数」的单层包装。
常见写法是直接在装饰器内部定义闭包，比如：
def log_calls(func):
def wrapper(*args, **kwargs):
print(f"Calling {func.__name__}")
return func(*args, **kwargs)
return wrapper
<p>@log_calls
def add(a, b):
return a + b
这里 @log_calls 等价于 add = log_calls(add)，log_calls 直接拿到 add 函数对象。
- 调用时不能加括号：
@log_calls✅，@log_calls()❌（会报TypeError: log_calls() missing 1 required positional argument） - 无法在装饰时传入配置，比如日志级别、开关标志等
- 所有被该装饰器修饰的函数共享同一套行为逻辑
带参数的装饰器必须是三层嵌套
带参数的装饰器不是直接接收被装饰函数，而是先接收你写的参数，再返回一个「真正干活」的装饰器（即不带参数版）。所以结构是：「参数 → 装饰器 → 函数」，共三层函数嵌套。
立即学习“Python免费学习笔记（深入）”；
典型写法：
def log_calls(level="INFO"):
def decorator(func):
def wrapper(*args, **kwargs):
print(f"[{level}] Calling {func.__name__}")
return func(*args, **kwargs)
return wrapper
return decorator
<p>@log_calls(level="DEBUG")
def add(a, b):
return a + b
这里 @log_calls(level="DEBUG") 实际执行顺序是：log_calls(level="DEBUG") 先运行，返回 decorator 函数；然后 Python 把 add 传给这个 decorator，最终得到 wrapper。
- 必须带括号，哪怕参数全用默认值：
@log_calls()合法，@log_calls会报错（TypeError: 'function' object is not callable） - 外层函数（
log_calls）负责接收配置，中间层（decorator）负责接收目标函数，最内层（wrapper）负责增强逻辑 - 每次调用
log_calls(...)都生成一个独立的decorator实例，因此不同参数组合互不影响
为什么不能混用？常见错误现象
最常见的误用是把带参数装饰器当不带参数用，或反过来。Python 在解析 @ 语法时严格按调用结果类型判断：
-
@my_dec→ Python 尝试调用my_dec(target_func)，要求my_dec是可调用且接受函数参数 -
@my_dec()→ Python 先调用my_dec()，期望返回值是一个可调用对象（即装饰器），再拿它去包装目标函数
如果写成：
@log_calls("DEBUG") # ✅ 正确：带括号，传参
@log_calls # ❌ 错误：Python 试图把 log_calls 当作装饰器函数，但它其实是参数接收函数
就会触发 TypeError: log_calls() missing 1 required positional argument: 'level'。
反过来，如果给不带参数装饰器加括号：
@log_calls() # ❌ log_calls 没定义参数，调用失败
会报 TypeError: log_calls() takes 1 positional argument but 0 were given。
想让一个装饰器同时支持带/不带参数？得用类型判断
有些库（如 functools.wraps 常见用法）希望装饰器既可 @dec 也可 @dec()。实现的关键是：在最外层判断第一个参数是不是函数。
核心思路：如果装饰器被调用时第一个参数是函数（callable(arg) and not kwargs），说明是不带参数用法；否则是带参数用法。
from functools import wraps
<p>def flexible_log(level=None):
if callable(level): # @flexible_log
func = level
@wraps(func)
def wrapper(*args, <strong>kwargs):
print(f"Calling {func.<strong>name</strong>}")
return func(*args, *<em>kwargs)
return wrapper
else: # @flexible_log(level="DEBUG")
def decorator(func):
@wraps(func)
def wrapper(</em>args, </strong>kwargs):
print(f"[{level}] Calling {func.<strong>name</strong>}")
return func(*args, **kwargs)
return wrapper
return decorator
这种写法灵活但容易出错——比如传入一个函数作为 level 参数（虽然少见），就会误判。实际项目中更推荐明确区分：用两个名字，或统一要求带括号，避免歧义。
最易忽略的是：带参数装饰器的外层函数（如 log_calls）本身不接触被装饰函数，它的返回值才是真正的装饰器。调试时如果在错误层级加断点，会发现根本进不去 wrapper。
