Python 装饰器带参数和不带参数的写法区别（完整对比）_技术教程

不带参数的装饰器是接收函数并返回新函数的单层包装，如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
@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）
无法在装饰时传入配置，比如日志级别、开关标志等
所有被该装饰器修饰的函数共享同一套行为逻辑

带参数的装饰器必须是三层嵌套

带参数的装饰器不是直接接收被装饰函数，而是先接收你写的参数，再返回一个「真正干活」的装饰器（即不带参数版）。所以结构是：「参数 → 装饰器 → 函数」，共三层函数嵌套。

典型写法：

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
@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
def flexible_log(level=None):
if callable(level):  # @flexible_log
func = level
@wraps(func)
def wrapper(*args, kwargs):
print(f"Calling {func.name}")
return func(*args, *kwargs)
return wrapper
else:  # @flexible_log(level="DEBUG")
def decorator(func):
@wraps(func)
def wrapper(args, kwargs):
print(f"[{level}] Calling {func.name}")
return func(*args, **kwargs)
return wrapper
return decorator

这种写法灵活但容易出错——比如传入一个函数作为 level 参数（虽然少见），就会误判。实际项目中更推荐明确区分：用两个名字，或统一要求带括号，避免歧义。

最易忽略的是：带参数装饰器的外层函数（如 log_calls）本身不接触被装饰函数，它的返回值才是真正的装饰器。调试时如果在错误层级加断点，会发现根本进不去 wrapper。