1. Python装饰器基础概念装饰器Decorator是Python中一种强大的语法特性它允许我们在不修改原函数代码的情况下为函数添加额外的功能。装饰器的本质是一个高阶函数它接收一个函数作为参数并返回一个新的函数。1.1 为什么需要装饰器想象你正在开发一个Web应用有多个视图函数需要添加相同的功能比如记录函数执行日志验证用户权限计算函数执行时间缓存函数结果传统做法是在每个函数内部添加这些代码但这会导致代码重复 - 相同的逻辑出现在多个地方核心逻辑与辅助功能混杂 - 降低了代码可读性难以维护 - 修改功能时需要修改多处装饰器通过将通用功能与业务逻辑分离完美解决了这些问题。1.2 装饰器的工作原理装饰器基于Python的几个重要特性函数是一等公民 - 可以像变量一样传递闭包 - 内部函数可以访问外部函数的变量可变参数 - 可以处理任意数量和类型的参数一个最简单的装饰器实现如下def simple_decorator(func): def wrapper(): print(Before function call) func() print(After function call) return wrapper simple_decorator def say_hello(): print(Hello!) say_hello()输出Before function call Hello! After function call2. 装饰器的核心实现技术2.1 函数装饰器函数装饰器是最常见的装饰器形式它通过嵌套函数实现功能扩展。让我们看一个更实用的例子 - 计算函数执行时间import time def timing_decorator(func): def wrapper(*args, **kwargs): start_time time.time() result func(*args, **kwargs) end_time time.time() print(f{func.__name__} executed in {end_time - start_time:.4f} seconds) return result return wrapper timing_decorator def calculate_sum(n): return sum(range(n)) calculate_sum(1000000)关键点*args, **kwargs确保装饰器可以处理任何参数的函数返回原函数的结果保持函数行为一致打印执行时间但不影响函数返回值2.2 带参数的装饰器有时我们需要装饰器本身也能接收参数这需要再加一层嵌套def repeat(num_times): def decorator(func): def wrapper(*args, **kwargs): for _ in range(num_times): result func(*args, **kwargs) return result return wrapper return decorator repeat(num_times3) def greet(name): print(fHello {name}) greet(Alice)输出Hello Alice Hello Alice Hello Alice这种三层嵌套结构是带参数装饰器的标准实现方式。3. 装饰器的高级应用3.1 类装饰器除了函数我们也可以用类实现装饰器这通常通过实现__call__方法来完成class CountCalls: def __init__(self, func): self.func func self.num_calls 0 def __call__(self, *args, **kwargs): self.num_calls 1 print(fCall {self.num_calls} of {self.func.__name__}) return self.func(*args, **kwargs) CountCalls def say_hello(): print(Hello!) say_hello() say_hello()输出Call 1 of say_hello Hello! Call 2 of say_hello Hello!类装饰器的优势在于可以更灵活地管理状态如这里的调用计数。3.2 装饰器堆叠Python允许在同一个函数上应用多个装饰器它们会从下往上依次执行def decorator1(func): def wrapper(): print(Decorator 1 before) func() print(Decorator 1 after) return wrapper def decorator2(func): def wrapper(): print(Decorator 2 before) func() print(Decorator 2 after) return wrapper decorator1 decorator2 def my_function(): print(Original function) my_function()输出Decorator 1 before Decorator 2 before Original function Decorator 2 after Decorator 1 after3.3 functools.wraps的作用使用装饰器时原函数的元信息如__name__、__doc__会被包装函数覆盖。functools.wraps可以解决这个问题from functools import wraps def my_decorator(func): wraps(func) def wrapper(*args, **kwargs): Wrapper function docstring print(Something is happening before the function is called.) return func(*args, **kwargs) return wrapper my_decorator def example(): Example function docstring print(Hello from example!) print(example.__name__) # 输出 example print(example.__doc__) # 输出 Example function docstring如果不使用wraps上述输出会是wrapper和Wrapper function docstring。4. 装饰器的实际应用场景4.1 日志记录装饰器非常适合用于记录函数调用信息import logging from functools import wraps logging.basicConfig(levellogging.INFO) def log_execution(func): wraps(func) def wrapper(*args, **kwargs): logging.info(fExecuting {func.__name__} with args: {args}, kwargs: {kwargs}) result func(*args, **kwargs) logging.info(fFinished executing {func.__name__}) return result return wrapper log_execution def add_numbers(a, b): return a b add_numbers(3, 5)4.2 权限验证在Web开发中装饰器常用于权限验证def requires_admin(func): wraps(func) def wrapper(user, *args, **kwargs): if not user.is_admin: raise PermissionError(Admin privileges required) return func(user, *args, **kwargs) return wrapper class User: def __init__(self, name, is_admin): self.name name self.is_admin is_admin requires_admin def delete_database(user): print(fDatabase deleted by {user.name}) admin User(Alice, True) regular User(Bob, False) delete_database(admin) # 正常执行 delete_database(regular) # 抛出PermissionError4.3 缓存与记忆化装饰器可以实现函数结果的缓存避免重复计算from functools import wraps def cache(func): memo {} wraps(func) def wrapper(*args): if args in memo: print(fReturning cached result for {args}) return memo[args] result func(*args) memo[args] result return result return wrapper cache def fibonacci(n): if n 1: return n return fibonacci(n-1) fibonacci(n-2) print(fibonacci(10)) # 第一次计算 print(fibonacci(10)) # 从缓存返回4.4 重试机制对于可能失败的操作可以使用装饰器实现自动重试import time from functools import wraps def retry(max_attempts3, delay1): def decorator(func): wraps(func) def wrapper(*args, **kwargs): attempts 0 while attempts max_attempts: try: return func(*args, **kwargs) except Exception as e: attempts 1 if attempts max_attempts: raise print(fAttempt {attempts} failed: {e}. Retrying in {delay} second(s)...) time.sleep(delay) return wrapper return decorator retry(max_attempts5, delay2) def unreliable_function(): import random if random.random() 0.7: raise ValueError(Something went wrong) return Success print(unreliable_function())5. 装饰器开发中的常见问题与解决方案5.1 装饰器导致函数签名改变使用装饰器后函数的签名参数信息会被包装函数覆盖。可以使用inspect模块的signature函数来验证import inspect def decorator(func): def wrapper(*args, **kwargs): return func(*args, **kwargs) return wrapper decorator def add(a: int, b: int) - int: Add two numbers return a b print(inspect.signature(add)) # 输出 (*args, **kwargs) 而不是 (a: int, b: int) - int解决方案是使用functools.wraps结合inspect模块的Signature对象来保留原始签名。5.2 装饰器与静态方法、类方法的交互当装饰器与staticmethod或classmethod一起使用时需要注意顺序class MyClass: decorator classmethod def class_method(cls): pass decorator staticmethod def static_method(): pass正确的顺序应该是装饰器在最外层classmethod和staticmethod在内层。5.3 装饰器性能考虑装饰器会引入额外的函数调用开销。对于性能敏感的代码可以考虑以下优化避免在装饰器内部进行复杂计算对于简单装饰器可以使用functools.lru_cache缓存装饰器结果在不需要装饰器功能时提供绕过装饰器的路径5.4 调试装饰器代码调试装饰器代码可能会比较困难因为错误堆栈会显示包装函数的信息。一些调试技巧使用functools.wraps保留原始函数名在装饰器中添加详细的日志记录使用pdb设置断点时注意是在包装函数还是原始函数中6. 装饰器的最佳实践6.1 保持装饰器简单每个装饰器应该只负责一个明确的功能。如果需要多个功能可以使用多个装饰器堆叠log_execution validate_arguments cache_result def complex_operation(a, b): # 函数实现 pass6.2 编写可测试的装饰器装饰器本身也应该被测试。编写装饰器时确保装饰器不修改原函数的行为除了添加的功能为装饰器编写单元测试验证其功能测试装饰器与各种类型函数的兼容性6.3 文档化装饰器良好的文档说明装饰器的用途、参数和行为def retry(max_attempts3, delay1): Decorator that retries a function upon failure. Args: max_attempts: Maximum number of retry attempts (default: 3) delay: Delay in seconds between attempts (default: 1) Raises: Original exception if all attempts fail def decorator(func): wraps(func) def wrapper(*args, **kwargs): # 实现代码 pass return wrapper return decorator6.4 考虑使用装饰器库对于常见功能可以考虑使用现有的装饰器库如functools.lru_cache: 内置的缓存装饰器functools.singledispatch: 单分派泛函数装饰器tenacity: 功能强大的重试装饰器库decorator: 简化装饰器创建的第三方库7. 装饰器的进阶主题7.1 装饰器与描述符协议装饰器可以与Python的描述符协议结合使用实现更强大的功能。例如我们可以创建一个装饰器将函数转换为属性描述符class property_decorator: def __init__(self, fgetNone, fsetNone, fdelNone): self.fget fget self.fset fset self.fdel fdel def __call__(self, func): if self.fget is None: self.fget func return self else: return property(self.fget, self.fset, self.fdel) def setter(self, func): self.fset func return self def deleter(self, func): self.fdel func return self class MyClass: def __init__(self, value): self._value value property_decorator() def value(self): return self._value value.setter def value(self, new_value): self._value new_value obj MyClass(10) print(obj.value) # 10 obj.value 20 print(obj.value) # 207.2 异步函数装饰器Python的async/await语法也支持装饰器但需要一些调整import asyncio from functools import wraps def async_timing_decorator(func): wraps(func) async def wrapper(*args, **kwargs): start_time asyncio.get_event_loop().time() result await func(*args, **kwargs) end_time asyncio.get_event_loop().time() print(f{func.__name__} executed in {end_time - start_time:.4f} seconds) return result return wrapper async_timing_decorator async def async_sleep(seconds): await asyncio.sleep(seconds) return Done asyncio.run(async_sleep(1))7.3 装饰器工厂模式对于复杂的装饰器逻辑可以使用工厂模式动态生成装饰器def decorator_factory(condition): def decorator(func): wraps(func) def wrapper(*args, **kwargs): if condition(*args, **kwargs): print(Condition met - executing function) return func(*args, **kwargs) else: print(Condition not met - skipping function) return None return wrapper return decorator def is_positive(x): return x 0 decorator_factory(lambda x: is_positive(x)) def process_number(x): return x * 2 print(process_number(5)) # 输出: Condition met... 10 print(process_number(-3)) # 输出: Condition not met... None7.4 装饰器与元编程装饰器本质上是一种元编程技术可以在编译时修改函数行为。结合其他元编程技术如元类可以实现更强大的功能class MetaDecorator(type): def __new__(cls, name, bases, namespace): for attr_name, attr_value in namespace.items(): if callable(attr_value) and not attr_name.startswith(__): namespace[attr_name] cls.decorate(attr_value) return super().__new__(cls, name, bases, namespace) classmethod def decorate(cls, func): wraps(func) def wrapper(*args, **kwargs): print(fCalling {func.__name__}) return func(*args, **kwargs) return wrapper class MyClass(metaclassMetaDecorator): def method1(self): print(Method 1) def method2(self): print(Method 2) obj MyClass() obj.method1() # 输出: Calling method1 \n Method 1 obj.method2() # 输出: Calling method2 \n Method 28. 装饰器的实际案例分析8.1 Flask路由装饰器Flask框架大量使用装饰器来实现路由定义from flask import Flask app Flask(__name__) app.route(/) def home(): return Welcome to the homepage! app.route(/user/username) def show_user(username): return fUser: {username}我们可以模拟实现一个简化版的路由装饰器class Router: def __init__(self): self.routes {} def route(self, path): def decorator(func): self.routes[path] func return func return decorator router Router() router.route(/) def home(): return Home page router.route(/about) def about(): return About page print(router.routes) # 输出: {/: function home..., /about: function about...}8.2 Django权限装饰器Django框架使用装饰器来处理视图权限from django.contrib.auth.decorators import login_required from django.http import HttpResponse login_required def my_view(request): return HttpResponse(Protected content)我们可以实现一个类似的权限装饰器def permission_required(permission): def decorator(view_func): wraps(view_func) def wrapper(request, *args, **kwargs): if request.user.has_perm(permission): return view_func(request, *args, **kwargs) else: return HttpResponse(Permission denied, status403) return wrapper return decorator permission_required(app.can_edit) def edit_view(request): return HttpResponse(Edit page)8.3 Pytest fixture装饰器Pytest测试框架使用装饰器来定义测试夹具import pytest pytest.fixture def database_connection(): conn create_connection() yield conn conn.close() def test_query(database_connection): result database_connection.query(SELECT 1) assert result 1我们可以模拟实现一个简单的测试夹具装饰器class TestFixture: def __init__(self): self.fixtures {} def fixture(self, func): self.fixtures[func.__name__] func return func def run_test(self, test_func): fixtures {} for name in test_func.__code__.co_varnames: if name in self.fixtures: fixtures[name] self.fixtures[name]() return test_func(**fixtures) fixture TestFixture() fixture.fixture def db_conn(): print(Creating connection) return connection def test_example(db_conn): print(fTesting with {db_conn}) fixture.run_test(test_example)9. 装饰器的性能优化9.1 减少装饰器开销装饰器会在每次函数调用时引入额外开销。对于高频调用的函数可以考虑以下优化将装饰器逻辑尽可能简化将不变的计算移到装饰器外部使用functools.lru_cache缓存装饰器结果9.2 选择性应用装饰器有时我们希望在特定条件下才应用装饰器逻辑def conditional_decorator(condition, decorator): def apply_decorator(func): if condition: return decorator(func) return func return apply_decorator DEBUG True conditional_decorator(DEBUG, timing_decorator) def critical_function(): # 重要函数实现 pass9.3 编译时装饰器对于性能关键的场景可以考虑使用functools.singledispatch或编写C扩展来实现编译时装饰器。10. 装饰器的替代方案虽然装饰器非常强大但在某些情况下其他设计模式可能更合适10.1 上下文管理器对于需要在代码块前后执行的操作上下文管理器可能是更好的选择from contextlib import contextmanager contextmanager def timing_context(): start_time time.time() yield end_time time.time() print(fExecution time: {end_time - start_time:.4f} seconds) with timing_context(): # 需要计时的代码块 time.sleep(1)10.2 中间件模式在Web框架中中间件模式可以替代部分装饰器功能class Middleware: def __init__(self, app): self.app app def __call__(self, environ, start_response): # 预处理逻辑 print(Before request) result self.app(environ, start_response) # 后处理逻辑 print(After request) return result def app(environ, start_response): start_response(200 OK, [(Content-Type, text/plain)]) return [bHello World] wrapped_app Middleware(app)10.3 组合模式对于复杂的扩展需求组合模式可能比多层装饰器更清晰class LoggedFunction: def __init__(self, func): self.func func def __call__(self, *args, **kwargs): print(fCalling {self.func.__name__}) return self.func(*args, **kwargs) class TimedFunction: def __init__(self, func): self.func func def __call__(self, *args, **kwargs): start time.time() result self.func(*args, **kwargs) end time.time() print(fExecution time: {end - start:.4f}s) return result def add(a, b): return a b logged_add LoggedFunction(add) timed_logged_add TimedFunction(logged_add) print(timed_logged_add(3, 5))11. 装饰器的未来发展Python装饰器仍在不断发展一些值得关注的趋势包括类型提示与装饰器的更好集成更强大的编译时装饰器支持与异步编程模型的深度整合跨语言装饰器如在Python和JavaScript之间共享装饰器逻辑12. 装饰器开发的经验总结在实际项目中使用装饰器多年后我总结了以下经验教训保持装饰器透明装饰器不应该改变函数的预期行为只添加辅助功能谨慎处理异常装饰器应该合理处理异常或者明确传递它们文档至关重要良好的文档可以避免装饰器被误用性能考量高频调用的函数要特别关注装饰器开销测试覆盖装饰器本身需要全面的测试包括边界情况避免过度使用不是所有横切关注点都适合用装饰器解决考虑可调试性确保装饰器不会使调试变得更加困难装饰器是Python中极其强大的工具但像所有强大的工具一样需要谨慎和明智地使用。当正确应用时它们可以使代码更干净、更模块化和更易于维护。
1. Python装饰器基础概念装饰器Decorator是Python中一种强大的语法特性它允许我们在不修改原函数代码的情况下为函数添加额外的功能。装饰器的本质是一个高阶函数它接收一个函数作为参数并返回一个新的函数。1.1 为什么需要装饰器想象你正在开发一个Web应用有多个视图函数需要添加相同的功能比如记录函数执行日志验证用户权限计算函数执行时间缓存函数结果传统做法是在每个函数内部添加这些代码但这会导致代码重复 - 相同的逻辑出现在多个地方核心逻辑与辅助功能混杂 - 降低了代码可读性难以维护 - 修改功能时需要修改多处装饰器通过将通用功能与业务逻辑分离完美解决了这些问题。1.2 装饰器的工作原理装饰器基于Python的几个重要特性函数是一等公民 - 可以像变量一样传递闭包 - 内部函数可以访问外部函数的变量可变参数 - 可以处理任意数量和类型的参数一个最简单的装饰器实现如下def simple_decorator(func): def wrapper(): print(Before function call) func() print(After function call) return wrapper simple_decorator def say_hello(): print(Hello!) say_hello()输出Before function call Hello! After function call2. 装饰器的核心实现技术2.1 函数装饰器函数装饰器是最常见的装饰器形式它通过嵌套函数实现功能扩展。让我们看一个更实用的例子 - 计算函数执行时间import time def timing_decorator(func): def wrapper(*args, **kwargs): start_time time.time() result func(*args, **kwargs) end_time time.time() print(f{func.__name__} executed in {end_time - start_time:.4f} seconds) return result return wrapper timing_decorator def calculate_sum(n): return sum(range(n)) calculate_sum(1000000)关键点*args, **kwargs确保装饰器可以处理任何参数的函数返回原函数的结果保持函数行为一致打印执行时间但不影响函数返回值2.2 带参数的装饰器有时我们需要装饰器本身也能接收参数这需要再加一层嵌套def repeat(num_times): def decorator(func): def wrapper(*args, **kwargs): for _ in range(num_times): result func(*args, **kwargs) return result return wrapper return decorator repeat(num_times3) def greet(name): print(fHello {name}) greet(Alice)输出Hello Alice Hello Alice Hello Alice这种三层嵌套结构是带参数装饰器的标准实现方式。3. 装饰器的高级应用3.1 类装饰器除了函数我们也可以用类实现装饰器这通常通过实现__call__方法来完成class CountCalls: def __init__(self, func): self.func func self.num_calls 0 def __call__(self, *args, **kwargs): self.num_calls 1 print(fCall {self.num_calls} of {self.func.__name__}) return self.func(*args, **kwargs) CountCalls def say_hello(): print(Hello!) say_hello() say_hello()输出Call 1 of say_hello Hello! Call 2 of say_hello Hello!类装饰器的优势在于可以更灵活地管理状态如这里的调用计数。3.2 装饰器堆叠Python允许在同一个函数上应用多个装饰器它们会从下往上依次执行def decorator1(func): def wrapper(): print(Decorator 1 before) func() print(Decorator 1 after) return wrapper def decorator2(func): def wrapper(): print(Decorator 2 before) func() print(Decorator 2 after) return wrapper decorator1 decorator2 def my_function(): print(Original function) my_function()输出Decorator 1 before Decorator 2 before Original function Decorator 2 after Decorator 1 after3.3 functools.wraps的作用使用装饰器时原函数的元信息如__name__、__doc__会被包装函数覆盖。functools.wraps可以解决这个问题from functools import wraps def my_decorator(func): wraps(func) def wrapper(*args, **kwargs): Wrapper function docstring print(Something is happening before the function is called.) return func(*args, **kwargs) return wrapper my_decorator def example(): Example function docstring print(Hello from example!) print(example.__name__) # 输出 example print(example.__doc__) # 输出 Example function docstring如果不使用wraps上述输出会是wrapper和Wrapper function docstring。4. 装饰器的实际应用场景4.1 日志记录装饰器非常适合用于记录函数调用信息import logging from functools import wraps logging.basicConfig(levellogging.INFO) def log_execution(func): wraps(func) def wrapper(*args, **kwargs): logging.info(fExecuting {func.__name__} with args: {args}, kwargs: {kwargs}) result func(*args, **kwargs) logging.info(fFinished executing {func.__name__}) return result return wrapper log_execution def add_numbers(a, b): return a b add_numbers(3, 5)4.2 权限验证在Web开发中装饰器常用于权限验证def requires_admin(func): wraps(func) def wrapper(user, *args, **kwargs): if not user.is_admin: raise PermissionError(Admin privileges required) return func(user, *args, **kwargs) return wrapper class User: def __init__(self, name, is_admin): self.name name self.is_admin is_admin requires_admin def delete_database(user): print(fDatabase deleted by {user.name}) admin User(Alice, True) regular User(Bob, False) delete_database(admin) # 正常执行 delete_database(regular) # 抛出PermissionError4.3 缓存与记忆化装饰器可以实现函数结果的缓存避免重复计算from functools import wraps def cache(func): memo {} wraps(func) def wrapper(*args): if args in memo: print(fReturning cached result for {args}) return memo[args] result func(*args) memo[args] result return result return wrapper cache def fibonacci(n): if n 1: return n return fibonacci(n-1) fibonacci(n-2) print(fibonacci(10)) # 第一次计算 print(fibonacci(10)) # 从缓存返回4.4 重试机制对于可能失败的操作可以使用装饰器实现自动重试import time from functools import wraps def retry(max_attempts3, delay1): def decorator(func): wraps(func) def wrapper(*args, **kwargs): attempts 0 while attempts max_attempts: try: return func(*args, **kwargs) except Exception as e: attempts 1 if attempts max_attempts: raise print(fAttempt {attempts} failed: {e}. Retrying in {delay} second(s)...) time.sleep(delay) return wrapper return decorator retry(max_attempts5, delay2) def unreliable_function(): import random if random.random() 0.7: raise ValueError(Something went wrong) return Success print(unreliable_function())5. 装饰器开发中的常见问题与解决方案5.1 装饰器导致函数签名改变使用装饰器后函数的签名参数信息会被包装函数覆盖。可以使用inspect模块的signature函数来验证import inspect def decorator(func): def wrapper(*args, **kwargs): return func(*args, **kwargs) return wrapper decorator def add(a: int, b: int) - int: Add two numbers return a b print(inspect.signature(add)) # 输出 (*args, **kwargs) 而不是 (a: int, b: int) - int解决方案是使用functools.wraps结合inspect模块的Signature对象来保留原始签名。5.2 装饰器与静态方法、类方法的交互当装饰器与staticmethod或classmethod一起使用时需要注意顺序class MyClass: decorator classmethod def class_method(cls): pass decorator staticmethod def static_method(): pass正确的顺序应该是装饰器在最外层classmethod和staticmethod在内层。5.3 装饰器性能考虑装饰器会引入额外的函数调用开销。对于性能敏感的代码可以考虑以下优化避免在装饰器内部进行复杂计算对于简单装饰器可以使用functools.lru_cache缓存装饰器结果在不需要装饰器功能时提供绕过装饰器的路径5.4 调试装饰器代码调试装饰器代码可能会比较困难因为错误堆栈会显示包装函数的信息。一些调试技巧使用functools.wraps保留原始函数名在装饰器中添加详细的日志记录使用pdb设置断点时注意是在包装函数还是原始函数中6. 装饰器的最佳实践6.1 保持装饰器简单每个装饰器应该只负责一个明确的功能。如果需要多个功能可以使用多个装饰器堆叠log_execution validate_arguments cache_result def complex_operation(a, b): # 函数实现 pass6.2 编写可测试的装饰器装饰器本身也应该被测试。编写装饰器时确保装饰器不修改原函数的行为除了添加的功能为装饰器编写单元测试验证其功能测试装饰器与各种类型函数的兼容性6.3 文档化装饰器良好的文档说明装饰器的用途、参数和行为def retry(max_attempts3, delay1): Decorator that retries a function upon failure. Args: max_attempts: Maximum number of retry attempts (default: 3) delay: Delay in seconds between attempts (default: 1) Raises: Original exception if all attempts fail def decorator(func): wraps(func) def wrapper(*args, **kwargs): # 实现代码 pass return wrapper return decorator6.4 考虑使用装饰器库对于常见功能可以考虑使用现有的装饰器库如functools.lru_cache: 内置的缓存装饰器functools.singledispatch: 单分派泛函数装饰器tenacity: 功能强大的重试装饰器库decorator: 简化装饰器创建的第三方库7. 装饰器的进阶主题7.1 装饰器与描述符协议装饰器可以与Python的描述符协议结合使用实现更强大的功能。例如我们可以创建一个装饰器将函数转换为属性描述符class property_decorator: def __init__(self, fgetNone, fsetNone, fdelNone): self.fget fget self.fset fset self.fdel fdel def __call__(self, func): if self.fget is None: self.fget func return self else: return property(self.fget, self.fset, self.fdel) def setter(self, func): self.fset func return self def deleter(self, func): self.fdel func return self class MyClass: def __init__(self, value): self._value value property_decorator() def value(self): return self._value value.setter def value(self, new_value): self._value new_value obj MyClass(10) print(obj.value) # 10 obj.value 20 print(obj.value) # 207.2 异步函数装饰器Python的async/await语法也支持装饰器但需要一些调整import asyncio from functools import wraps def async_timing_decorator(func): wraps(func) async def wrapper(*args, **kwargs): start_time asyncio.get_event_loop().time() result await func(*args, **kwargs) end_time asyncio.get_event_loop().time() print(f{func.__name__} executed in {end_time - start_time:.4f} seconds) return result return wrapper async_timing_decorator async def async_sleep(seconds): await asyncio.sleep(seconds) return Done asyncio.run(async_sleep(1))7.3 装饰器工厂模式对于复杂的装饰器逻辑可以使用工厂模式动态生成装饰器def decorator_factory(condition): def decorator(func): wraps(func) def wrapper(*args, **kwargs): if condition(*args, **kwargs): print(Condition met - executing function) return func(*args, **kwargs) else: print(Condition not met - skipping function) return None return wrapper return decorator def is_positive(x): return x 0 decorator_factory(lambda x: is_positive(x)) def process_number(x): return x * 2 print(process_number(5)) # 输出: Condition met... 10 print(process_number(-3)) # 输出: Condition not met... None7.4 装饰器与元编程装饰器本质上是一种元编程技术可以在编译时修改函数行为。结合其他元编程技术如元类可以实现更强大的功能class MetaDecorator(type): def __new__(cls, name, bases, namespace): for attr_name, attr_value in namespace.items(): if callable(attr_value) and not attr_name.startswith(__): namespace[attr_name] cls.decorate(attr_value) return super().__new__(cls, name, bases, namespace) classmethod def decorate(cls, func): wraps(func) def wrapper(*args, **kwargs): print(fCalling {func.__name__}) return func(*args, **kwargs) return wrapper class MyClass(metaclassMetaDecorator): def method1(self): print(Method 1) def method2(self): print(Method 2) obj MyClass() obj.method1() # 输出: Calling method1 \n Method 1 obj.method2() # 输出: Calling method2 \n Method 28. 装饰器的实际案例分析8.1 Flask路由装饰器Flask框架大量使用装饰器来实现路由定义from flask import Flask app Flask(__name__) app.route(/) def home(): return Welcome to the homepage! app.route(/user/username) def show_user(username): return fUser: {username}我们可以模拟实现一个简化版的路由装饰器class Router: def __init__(self): self.routes {} def route(self, path): def decorator(func): self.routes[path] func return func return decorator router Router() router.route(/) def home(): return Home page router.route(/about) def about(): return About page print(router.routes) # 输出: {/: function home..., /about: function about...}8.2 Django权限装饰器Django框架使用装饰器来处理视图权限from django.contrib.auth.decorators import login_required from django.http import HttpResponse login_required def my_view(request): return HttpResponse(Protected content)我们可以实现一个类似的权限装饰器def permission_required(permission): def decorator(view_func): wraps(view_func) def wrapper(request, *args, **kwargs): if request.user.has_perm(permission): return view_func(request, *args, **kwargs) else: return HttpResponse(Permission denied, status403) return wrapper return decorator permission_required(app.can_edit) def edit_view(request): return HttpResponse(Edit page)8.3 Pytest fixture装饰器Pytest测试框架使用装饰器来定义测试夹具import pytest pytest.fixture def database_connection(): conn create_connection() yield conn conn.close() def test_query(database_connection): result database_connection.query(SELECT 1) assert result 1我们可以模拟实现一个简单的测试夹具装饰器class TestFixture: def __init__(self): self.fixtures {} def fixture(self, func): self.fixtures[func.__name__] func return func def run_test(self, test_func): fixtures {} for name in test_func.__code__.co_varnames: if name in self.fixtures: fixtures[name] self.fixtures[name]() return test_func(**fixtures) fixture TestFixture() fixture.fixture def db_conn(): print(Creating connection) return connection def test_example(db_conn): print(fTesting with {db_conn}) fixture.run_test(test_example)9. 装饰器的性能优化9.1 减少装饰器开销装饰器会在每次函数调用时引入额外开销。对于高频调用的函数可以考虑以下优化将装饰器逻辑尽可能简化将不变的计算移到装饰器外部使用functools.lru_cache缓存装饰器结果9.2 选择性应用装饰器有时我们希望在特定条件下才应用装饰器逻辑def conditional_decorator(condition, decorator): def apply_decorator(func): if condition: return decorator(func) return func return apply_decorator DEBUG True conditional_decorator(DEBUG, timing_decorator) def critical_function(): # 重要函数实现 pass9.3 编译时装饰器对于性能关键的场景可以考虑使用functools.singledispatch或编写C扩展来实现编译时装饰器。10. 装饰器的替代方案虽然装饰器非常强大但在某些情况下其他设计模式可能更合适10.1 上下文管理器对于需要在代码块前后执行的操作上下文管理器可能是更好的选择from contextlib import contextmanager contextmanager def timing_context(): start_time time.time() yield end_time time.time() print(fExecution time: {end_time - start_time:.4f} seconds) with timing_context(): # 需要计时的代码块 time.sleep(1)10.2 中间件模式在Web框架中中间件模式可以替代部分装饰器功能class Middleware: def __init__(self, app): self.app app def __call__(self, environ, start_response): # 预处理逻辑 print(Before request) result self.app(environ, start_response) # 后处理逻辑 print(After request) return result def app(environ, start_response): start_response(200 OK, [(Content-Type, text/plain)]) return [bHello World] wrapped_app Middleware(app)10.3 组合模式对于复杂的扩展需求组合模式可能比多层装饰器更清晰class LoggedFunction: def __init__(self, func): self.func func def __call__(self, *args, **kwargs): print(fCalling {self.func.__name__}) return self.func(*args, **kwargs) class TimedFunction: def __init__(self, func): self.func func def __call__(self, *args, **kwargs): start time.time() result self.func(*args, **kwargs) end time.time() print(fExecution time: {end - start:.4f}s) return result def add(a, b): return a b logged_add LoggedFunction(add) timed_logged_add TimedFunction(logged_add) print(timed_logged_add(3, 5))11. 装饰器的未来发展Python装饰器仍在不断发展一些值得关注的趋势包括类型提示与装饰器的更好集成更强大的编译时装饰器支持与异步编程模型的深度整合跨语言装饰器如在Python和JavaScript之间共享装饰器逻辑12. 装饰器开发的经验总结在实际项目中使用装饰器多年后我总结了以下经验教训保持装饰器透明装饰器不应该改变函数的预期行为只添加辅助功能谨慎处理异常装饰器应该合理处理异常或者明确传递它们文档至关重要良好的文档可以避免装饰器被误用性能考量高频调用的函数要特别关注装饰器开销测试覆盖装饰器本身需要全面的测试包括边界情况避免过度使用不是所有横切关注点都适合用装饰器解决考虑可调试性确保装饰器不会使调试变得更加困难装饰器是Python中极其强大的工具但像所有强大的工具一样需要谨慎和明智地使用。当正确应用时它们可以使代码更干净、更模块化和更易于维护。
