当然，这里有且仅有一条原创的Python文章标题Python装饰器从入门到精通的终极指南-CSDN博客

# Python装饰器从入门到精通的终极指南

什么是装饰器

Python装饰器是一种强大的语法特性，它允许用户在不修改原始函数代码的情况下，增加或改变函数的行为。装饰器本质上是一个接受函数作为参数并返回一个新函数的高阶函数。这种机制为Python程序员提供了极大的灵活性，使得代码更加简洁、可读性更高。

装饰器的基本语法

装饰器使用@符号作为语法糖，放置在函数定义之前。当Python解释器遇到装饰器时，它会立即执行装饰器函数，并将被装饰的函数作为参数传递。装饰器返回的函数将替换原始函数。

简单装饰器示例

下面是一个简单的装饰器示例，它记录了函数的执行时间：

import timedef timer_decorator(func):    def wrapper(args, kwargs):        start_time = time.time()        result = func(args, kwargs)        end_time = time.time()        print(f{func.__name__} 执行时间: {end_time - start_time}秒)        return result    return wrapper@timer_decoratordef example_function():    time.sleep(2)    print(函数执行完毕)example_function()

带参数的装饰器

有时我们需要装饰器本身能够接受参数，这就需要使用两层嵌套函数。第一层函数接受装饰器参数，第二层函数接受被装饰的函数。

参数化装饰器示例

下面是一个带参数的装饰器示例，它可以控制函数执行的重复次数：

def repeat(num_times):    def decorator_repeat(func):        def wrapper(args, kwargs):            for _ in range(num_times):                result = func(args, kwargs)            return result        return wrapper    return decorator_repeat@repeat(num_times=3)def greet(name):    print(fHello {name})greet(World)

类装饰器

除了函数装饰器，Python还支持类装饰器。类装饰器通过实现__call__方法，使类的实例可以像函数一样被调用。

类装饰器示例

下面是一个使用类实现的装饰器示例：

class CountCalls:    def __init__(self, func):        self.func = func        self.num_calls = 0    def __call__(self, args, kwargs):        self.num_calls += 1        print(f调用第{self.num_calls}次)        return self.func(args, kwargs)@CountCallsdef say_hello():    print(Hello!)say_hello()say_hello()

内置装饰器

Python提供了一些内置装饰器，如@property、@staticmethod和@classmethod，它们在面向对象编程中非常有用。

@property装饰器

@property装饰器允许将类方法转换为属性，从而提供更简洁的属性访问语法：

class Circle:    def __init__(self, radius):        self._radius = radius    @property    def radius(self):        return self._radius    @radius.setter    def radius(self, value):        if value >= 0:            self._radius = value        else:            raise ValueError(半径不能为负)circle = Circle(5)print(circle.radius)  # 输出: 5circle.radius = 10print(circle.radius)  # 输出: 10

装饰器的高级应用

装饰器可以组合使用，也可以用于实现各种高级模式，如缓存、权限检查、日志记录等。

多个装饰器组合使用

多个装饰器可以同时应用于一个函数，它们的执行顺序是从下往上：

def decorator1(func):    def wrapper():        print(装饰器1)        func()    return wrapperdef decorator2(func):    def wrapper():        print(装饰器2)        func()    return wrapper@decorator1@decorator2def say_hello():    print(Hello!)say_hello()# 输出:# 装饰器1# 装饰器2# Hello!

装饰器的最佳实践

在使用装饰器时，需要注意保留原始函数的元数据，可以使用functools.wraps装饰器来避免元数据丢失的问题。

使用functools.wraps

functools.wraps装饰器可以帮助保留原始函数的名称、文档字符串等元数据：

import functoolsdef my_decorator(func):    @functools.wraps(func)    def wrapper(args, kwargs):        print(装饰器操作)        return func(args, kwargs)    return wrapper@my_decoratordef example():    这是一个示例函数    print(函数执行)print(example.__name__)  # 输出: exampleprint(example.__doc__)   # 输出: 这是一个示例函数

结语

Python装饰器是一项强大而灵活的功能，掌握了装饰器的使用可以让代码更加简洁、优雅。从简单的函数装饰器到带参数的装饰器，再到类装饰器，每种类型都有其适用的场景。通过本文的学习，您应该已经对Python装饰器有了全面的了解，并能够在实际开发中灵活运用。