Python怎么实现一个简单的装饰器工厂_通过闭包动态生成装饰器-Python教程-PHP中文网

装饰器工厂是返回装饰器的函数，它接收配置参数并利用闭包动态生成定制化装饰器；普通装饰器直接接收函数并返回新函数，而工厂需多一层调用（如@my_factory(arg=...)）。

python怎么实现一个简单的装饰器工厂_通过闭包动态生成装饰器

什么是装饰器工厂？它和普通装饰器有什么区别

装饰器工厂不是装饰器本身，而是一个返回装饰器的函数。它利用闭包捕获外部参数，在运行时动态生成定制化的装饰器。普通装饰器接收一个函数并返回新函数；装饰器工厂则接收配置参数（比如日志级别、重试次数），再返回那个“真正干活”的装饰器。

常见错误现象：TypeError: my_decorator() missing 1 required positional argument: 'func'——这往往是因为少写了一层调用，把工厂函数当成了装饰器直接用了。

工厂函数必须返回一个可调用对象（通常是内部定义的装饰器函数）
装饰器函数本身必须接收 func 参数，并返回包装后的函数
调用时要写成 @my_factory(arg=...)，而不是 @my_factory

怎么写一个带参数的日志装饰器工厂

这个场景很典型：你想控制是否打印日志、日志前缀用什么、是否记录执行时间。用闭包把参数存进外层作用域，内层装饰器就能访问。

def log_calls(prefix="CALL", enabled=True):
    def decorator(func):
        def wrapper(*args, **kwargs):
            if not enabled:
                return func(*args, **kwargs)
            print(f"[{prefix}] Calling {func.__name__}")
            result = func(*args, **kwargs)
            print(f"[{prefix}] Done {func.__name__}")
            return result
        return wrapper
    return decorator

使用方式：

@log_calls(prefix="DEBUG", enabled=True)
def hello():
print("hi")

注意点：

log_calls(...) 先被调用，返回 decorator 函数
然后 Python 用这个 decorator 去装饰 hello
如果漏掉括号（如 @log_calls），就会报错：Python 传给 decorator 的是 hello，但 log_calls 并不接收函数作为参数

为什么需要用 `functools.wraps`？不加会出什么问题

不加 functools.wraps，被装饰函数的元信息（name、doc、module）会丢失，变成 wrapper 的信息。这对调试、文档生成、类型检查（如 inspect.signature）都会造成干扰。

修改上面的 wrapper 定义：

from functools import wraps
<p>def log_calls(prefix="CALL", enabled=True):
def decorator(func):
@wraps(func)  # ← 关键一行
def wrapper(*args, <strong>kwargs):
if not enabled:
return func(*args, *<em>kwargs)
print(f"[{prefix}] Calling {func.<strong>name</strong>}")
result = func(</em>args, </strong>kwargs)
print(f"[{prefix}] Done {func.<strong>name</strong>}")
return result
return wrapper
return decorator</p>

性能影响几乎为零，但兼容性极重要——尤其当你写的装饰器要被别人复用，或集成进框架（如 FastAPI 的依赖注入）时，name 错乱会导致路由注册失败、依赖解析异常等隐蔽问题。