<think>我们首先讲解装饰器的原理和使用方法。装饰器是Python中一个强大的功能，它允许我们修改或增强函数的行为而不改变函数本身的定义。 ### 装饰器原理 装饰器本质上是一个高阶函数，它接受一个函数作为参数，并返回一个新的函数。使用装饰器可以在不修改原函数代码的情况下，给函数增加新的功能。 ### 基本结构 一个最简单的装饰器示例： ```python def my_decorator(func): def wrapper(): print("在函数调用前执行一些操作") func() # 调用原始函数 print("在函数调用后执行一些操作") return wrapper @my_decorator def say_hello(): print("Hello!") # 调用被装饰的函数 say_hello() ``` 输出： ``` 在函数调用前执行一些操作 Hello! 在函数调用后执行一些操作 ``` ### 原理解释 - 当使用`@my_decorator`装饰`say_hello`时，相当于执行了：`say_hello = my_decorator(say_hello)` - 所以，调用`say_hello()`实际上调用的是`wrapper()`函数。 ### 处理带参数的函数 如果被装饰的函数带有参数，我们需要在内部函数`wrapper`中使用相同的参数。我们可以使用`*args`和`**kwargs`来接收任意参数。 ```python def decorator_with_args(func): def wrapper(*args, **kwargs): print("装饰器：开始") result = func(*args, **kwargs) # 调用原始函数并传递参数 print("装饰器：结束") return result return wrapper @decorator_with_args def greet(name): print(f"Hello, {name}") greet("Alice") ``` 输出： ``` 装饰器：开始 Hello, Alice 装饰器：结束 ``` ### 带参数的装饰器 有时候我们想让装饰器本身也带参数。这就需要再嵌套一层函数，例如： ```python 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 say_hello(): print("Hello") say_hello() ``` 输出： ``` Hello Hello Hello ``` ### 类装饰器 除了函数装饰器，我们还可以使用类作为装饰器。类装饰器通常通过实现`__call__`方法来实现。 ```python 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) @CountCalls def example(): print("这是一个示例函数") example() example() ``` 输出： ``` 调用次数: 1 这是一个示例函数 调用次数: 2 这是一个示例函数 ``` ### 使用场景 装饰器常用于以下场景： - 日志记录 - 性能测试（计算函数运行时间） - 权限校验 - 缓存 ### 注意事项 1. 使用装饰器会改变函数的元信息（如函数名、文档字符串），可以使用`functools.wraps`来保留这些信息。 ```python from functools import wraps def my_decorator(func): @wraps(func) def wrapper(*args, **kwargs): print("装饰器") return func(*args, **kwargs) return wrapper @my_decorator def example(): """示例函数的文档字符串""" print("示例函数") print(example.__name__) # 输出 'example' print(example.__doc__) # 输出 '示例函数的文档字符串' ``` 2. 装饰器的顺序：多个装饰器时，靠近函数定义的装饰器先执行（从下往上）。 ```python @decorator1 @decorator2 def my_func(): pass # 相当于：my_func = decorator1(decorator2(my_func)) ``` 以上是装饰器的基本原理和使用方法。作为初学者，建议多练习几个例子来加深理解。 §§相关问题§§ 1. 装饰器在什么情况下会改变函数的元信息？如何避免？ 2. 如何编写一个可以接受任意参数的装饰器？ 3. 请举例说明装饰器在Web框架（如Flask）中的应用。 4. 使用类装饰器和函数装饰器各有什么优缺点？ 5. 如何实现一个装饰器，用于计算函数的执行时间？ </think> ### Python装饰器的原理与使用方法详解 #### 一、装饰器原理 装饰器本质是**高阶函数**，遵循以下核心机制： 1. **函数作为对象**：Python中函数是"一等公民"，可被赋值/传递 2. **闭包特性**：内层函数可访问外层函数的变量 3. **@语法糖**：`@decorator` 等价于 `func = decorator(func)` #### 二、基础使用 **简单装饰器示例**： ```python def basic_decorator(func): def wrapper(): print("函数执行前操作") func() # 调用原始函数 print("函数执行后操作") return wrapper @basic_decorator def greet(): print("Hello World!") greet() ``` 输出： ``` 函数执行前操作 Hello World! 函数执行后操作 ``` #### 三、进阶用法 1. **处理带参数的函数**： ```python def param_decorator(func): def wrapper(*args, **kwargs): print(f"准备执行 {func.__name__}") result = func(*args, **kwargs) # 传递参数 print("执行完成") return result return wrapper @param_decorator def add(a, b): return a + b print(add(3, 5)) # 输出：准备执行 add → 执行完成 → 8 ``` 2. **带参数的装饰器**： ```python def repeat(n=2): # 装饰器参数 def actual_decorator(func): # 接收函数 def wrapper(*args, **kwargs): for _ in range(n): func(*args, **kwargs) return wrapper return actual_decorator @repeat(n=3) def say_hello(): print("Hello!") say_hello() # 输出3次 Hello! ``` 3. **类装饰器**： ```python class Timer: def __init__(self, func): self.func = func def __call__(self, *args, **kwargs): import time start = time.time() result = self.func(*args, **kwargs) end = time.time() print(f"{self.func.__name__} 执行耗时: {end-start:.4f}秒") return result @Timer def long_operation(): import time time.sleep(2) long_operation() # 输出执行耗时 ``` #### 四、实际应用场景 - 权限验证（Web框架中常用） - 日志记录 - 性能测试 - 缓存机制 - 输入合法性检查 #### 五、重要注意事项 1. **保留元信息**：使用`functools.wraps`避免函数名等属性丢失 ```python from functools import wraps def proper_decorator(func): @wraps(func) # 保留原始函数信息 def wrapper(*args, **kwargs): return func(*args, **kwargs) return wrapper ``` 2. **装饰器叠加顺序**： ```python @decorator1 @decorator2 def func(): ... # 等价于 func = decorator1(decorator2(func)) ```