Python 中的 @wraps 装饰器使用详解

   

---

概要

在Python编程中，装饰器（decorators）是一种非常强大的工具，可以在不修改原有函数代码的前提下，扩展函数的功能。而在编写装饰器时，functools模块中的@wraps装饰器是一个不可或缺的工具。本文将详细介绍@wraps的作用和使用方法，并通过示例代码展示其实际应用。

---

一、什么是装饰器？

在深入了解@wraps之前，我们先简单介绍一下装饰器。装饰器本质上是一个高阶函数，它接受一个函数作为参数，并返回一个新函数。装饰器常用于在函数执行前后添加额外的行为，如日志记录、访问控制、缓存等。

示例代码：

def my_decorator(func):
    def wrapper():
        print("Something is happening before the function is called.")
        func()
        print("Something is happening after the function is called.")
    return wrapper

@my_decorator
def say_hello():
    print("Hello!")

say_hello()

在这个示例中，my_decorator是一个装饰器，它在目标函数say_hello执行前后打印额外的信息。

二、@wraps的作用

当我们使用装饰器时，装饰后的函数实际上是包装器函数（wrapper function），而不是原来的函数。这会导致一些问题，例如：

1. 原函数的名称和文档字符串（docstring）被包装器函数覆盖。

2. 原函数的属性（如__name__和__doc__）丢失。

为