@wraps 修饰器：让 Python 代码简短又可爱 从实例入手了解它

在 Python 编程的世界中，@wraps 修饰器是一个强大而实用的工具，它能让我们的代码更加简洁、清晰和易于理解。接下来，让我们通过具体的实例来深入了解它的魅力。

什么是 @wraps 修饰器呢？简单来说，它用于保留被修饰函数的元数据，比如函数的名称、文档字符串（docstring）和参数信息等。这在编写可维护和可读性高的代码时非常重要。

假设我们有一个装饰器函数 my_decorator，它用于记录函数的调用次数。

def my_decorator(func):
    def wrapper(*args, **kwargs):
        print(f"Calling {func.__name__}")
        result = func(*args, **kwargs)
        return result
    return wrapper

现在，如果我们用这个装饰器来装饰一个函数 my_function ：

@my_decorator
def my_function(x, y):
    """This is my function"""
    return x + y

当我们查看 my_function 的元数据时，会发现它的名称变成了 wrapper ，文档字符串也丢失了。这就是 @wraps 修饰器发挥作用的地方。

我们修改装饰器函数如下：

from functools import wraps

def my_decorator(func):
    @wraps(func)
    def wrapper(*args, **kwargs):
        print(f"Calling {func.__name__}")
        result = func(*args, **kwargs)
        return result
    return wrapper

再次使用这个装饰后的 my_function ，它的元数据就被正确保留了，函数名称仍然是 my_function ，文档字符串也还是 This is my function 。

@wraps 修饰器的应用场景非常广泛。比如在创建多个具有相似功能的装饰器时，它可以确保每个被装饰的函数都能保持其原有的特性。又或者在开发库和框架时，使用 @wraps 可以让用户更方便地理解和使用被装饰的函数。

@wraps 修饰器虽然看似简单，但其作用却不容小觑。它能让我们在使用装饰器的不丢失函数的重要元信息，使得代码更加规范和易于维护。通过以上的实例，相信您对 @wraps 修饰器已经有了更清晰的认识和理解。在今后的 Python 编程中，不妨多多运用它，让您的代码变得简短又可爱！