在 python 3 中,给包装函数添加 functools.wraps(原函数),可以保留函数名和文档字符串,并通过 __wrapped__ 让 inspect.signature 默认取得原函数签名。wraps 不会自动改变包装函数的调用规则;参数仍要正确转发,返回值也要显式返回。以下三个示例分别保存为 demo.py,执行 python demo.py。

给包装函数添加 wraps,保留名称并转发返回值
装饰器接收一个函数,返回新的 wrapper。wrapper 使用 *args 和 **kwargs 转交位置参数与关键字参数,用 return 把调用结果交回调用者。wraps 加在 wrapper 上,传入被装饰的函数。
from functools import wraps
def trace(func):
@wraps(func)
def wrapper(*args, **kwargs):
print("调用:", func.__name__)
return func(*args, **kwargs)
return wrapper
@trace
def greet(name, *, prefix="你好"):
"""生成问候语。"""
return f"{prefix},{name}"
assert greet("小林", prefix="早上好") == "早上好,小林"
assert greet.__name__ == "greet"
assert greet.__doc__ == "生成问候语。"
print(greet.__name__, greet.__doc__)预期打印调用名称,再打印 greet 和文档字符串。如果漏掉 return func(...),包装函数会返回 None;如果漏掉 **kwargs,带 prefix 的调用就不能按原接口工作。元信息保留与调用转发需要分别实现。

立即学习“Python免费学习笔记(深入)”;
用 inspect.signature 区分原函数签名和包装函数签名
wraps 设置 __wrapped__,inspect.signature 默认沿着它读取原函数。指定 follow_wrapped=False 可以检查 wrapper 自身的参数结构。两种结果用途不同,不代表 Python 在运行时把 wrapper 的形参改写了。
import inspect
from functools import wraps
def trace(func):
@wraps(func)
def wrapper(*args, **kwargs):
return func(*args, **kwargs)
return wrapper
@trace
def add(a, b=2):
return a + b
original = inspect.signature(add)
wrapper = inspect.signature(add, follow_wrapped=False)
assert str(original) == "(a, b=2)"
assert str(wrapper) == "(*args, **kwargs)"
assert add(3) == 5
print(original)
print(wrapper)预期依次打印 (a, b=2) 与 (*args, **kwargs)。路由或文档工具可以利用原签名;业务参数验证仍要自行处理,wraps 不会根据类型注解自动验证或转换输入。
通过 __wrapped__ 调用原函数,核对装饰器是否执行
__wrapped__ 指向被包装的函数。测试时可以直接调用它来隔离装饰器副作用;多层装饰时通常只解开当前一层。这个入口也能跳过包装逻辑,不能把装饰器包装本身当成不可绕过的权限边界。
from functools import wraps
calls = []
def trace(func):
@wraps(func)
def wrapper(*args, **kwargs):
calls.append(func.__name__)
return func(*args, **kwargs)
return wrapper
@trace
def double(number):
return number * 2
assert double(5) == 10
assert calls == ["double"]
assert double.__wrapped__(5) == 10
assert calls == ["double"]
try:
double()
except TypeError:
print("缺少参数仍由原函数调用报错")
else:
raise AssertionError("缺少 number 应失败")直接调用 __wrapped__ 后,calls 不增加。最后一次缺参调用会先进入 wrapper,再在转交给 double 时抛 TypeError;因此是否记录调用和是否成功执行函数也应分别判断。


















