<think>我们参考了提供的引用资料，并基于对Python装饰器的理解来回答用户问题。 定义：装饰器本质上是一个函数，它可以让其他函数在不需要做任何代码变动的前提下增加额外功能。装饰器的返回值也是一个函数对象，经常用于有切面需求的场景，比如：插入日志、性能测试、事务处理、缓存、权限校验等场景。装饰器是解决这类问题的绝佳设计，有了装饰器，我们就可以抽离出大量与函数功能本身无关的代码并继续重用。 使用原因：装饰器能够在不改变原有函数定义的情况下，动态地增加功能，提高了代码的复用性，并且使得代码更加简洁优雅。 使用方法：装饰器通常使用@符号放在函数定义的前面。实际上，装饰器就是一个返回函数的高阶函数。我们可以定义装饰器函数，然后用它来装饰其他函数。 示例： 1. 最简单的装饰器示例（无参）： 定义一个装饰器，用于在函数执行前后打印日志。 2. 使用functools.wraps保留原函数的元信息（如函数名等）： 因为装饰器实际上返回的是一个新的函数，所以原函数的元信息会丢失。通过functools.wraps可以保留这些信息。 3. 带参数的装饰器： 有时候我们需要装饰器本身传入参数，这就需要编写一个返回装饰器的高阶函数。 4. 类装饰器： 除了函数装饰器，还可以使用类来实现装饰器，通过实现__call__方法。 5. 多个装饰器：一个函数可以同时使用多个装饰器，执行顺序是从下往上（或从内到外）。 下面我们分别给出示例： </think> ### Python装饰器的定义、使用原因及使用方法 #### **1. 定义** 装饰器（Decorator）是Python中一种**动态扩展函数功能**的高级语法，本质是一个**接收函数作为参数并返回新函数**的可调用对象（函数或类）。它通过闭包实现，在不修改原函数代码的前提下增加新功能，语法形式为 `@decorator_name`[^1][^2]。 --- #### **2. 使用原因** - **代码复用**：避免相同功能代码重复（如日志记录、权限校验）。 - **非侵入式扩展**：不修改原函数逻辑即可添加新行为（如性能测试、缓存）。 - **解耦核心逻辑与辅助功能**：保持函数职责单一，提升可维护性[^1][^3]。 --- #### **3. 使用方法** ##### (1) 基础装饰器（函数实现） ```python def log_time(func): # 装饰器函数 def wrapper(*args, **kwargs): start = time.time() result = func(*args, **kwargs) # 执行原函数 print(f"耗时: {time.time() - start:.4f}s") return result return wrapper @log_time # 等价于 my_func = log_time(my_func) def my_func(n): return sum(range(n)) my_func(1000000) # 输出: 耗时: 0.0123s ``` ##### (2) 保留元信息（`@wraps`） ```python from functools import wraps def auth_required(func): @wraps(func) # 保留原函数的名称、文档等元信息 def wrapper(*args, **kwargs): if check_user_auth(): # 权限校验逻辑 return func(*args, **kwargs) raise PermissionError("无权限访问") return wrapper @auth_required def delete_file(filename): """删除指定文件""" os.remove(filename) print(delete_file.__name__) # 输出: delete_file (而非wrapper) ``` ##### (3) 带参数的装饰器 ```python def repeat(n=3): # 外层接收参数 def decorator(func): # 内层接收函数 @wraps(func) def wrapper(*args, **kwargs): for _ in range(n): result = func(*args, **kwargs) return result return wrapper return decorator @repeat(n=5) def greet(name): print(f"Hello, {name}!") greet("Alice") # 打印5次"Hello, Alice!" ``` ##### (4) 类装饰器（通过 `__call__` 实现） ```python class CountCalls: def __init__(self, func): self.func = func self.calls = 0 def __call__(self, *args, **kwargs): self.calls += 1 print(f"函数已被调用 {self.calls} 次") return self.func(*args, **kwargs) @CountCalls def say_hello(): print("Hello!") say_hello() # 输出: 函数已被调用1次 → Hello! say_hello() # 输出: 函数已被调用2次 → Hello! ``` --- #### **4. 典型应用场景** - **日志记录**：自动记录函数执行信息。 - **权限控制**：验证用户权限（如 `@login_required`）。 - **性能监控**：统计函数执行时间。 - **缓存加速**：实现 `@lru_cache` 等缓存机制。 - **类方法扩展**：`@classmethod`, `@property` 等内置装饰器[^3][^4]。 ---