Python装饰器：语法糖与高级函数应用的完美融合

装饰器是Python中一项强大而优雅的特性，它允许程序员在不修改原始函数代码的情况下，为函数添加额外的功能。其本质上是一个高阶函数，它接收一个函数作为参数，并返回一个新的函数。这种设计模式遵循了开放封闭原则，即对扩展开放，对修改封闭。

装饰器的基本语法与工作原理

装饰器的基本语法使用@符号，将其置于函数定义之前。例如，一个简单的计时装饰器可以这样实现：

import time
def 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:.4f}秒)
        return result
    return wrapper

@timer_decorator
def example_function():
    time.sleep(1)
    return 执行完毕

当调用example_function()时，实际上调用的是装饰器返回的wrapper函数，该函数在调用原始函数前后添加了计时功能。

带参数的装饰器实现

装饰器本身也可以接受参数，这需要创建两层嵌套函数。例如，一个可自定义重试次数的装饰器：

def retry_decorator(max_retries=3):
    def decorator(func):
        def wrapper(args, kwargs):
            attempts = 0
            while attempts < max_retries:
                try:
                    return func(args, kwargs)
                except Exception as e:
                    attempts += 1
                    print(f尝试 {attempts} 失败，错误: {e})
            raise Exception(f函数 {func.__name__} 在 {max_retries} 次尝试后仍失败)
        return wrapper
    return decorator

@retry_decorator(max_retries=5)
def potentially_unstable_function():
    # 可能失败的操作
    pass

类装饰器与方法装饰器

除了函数装饰器，Python还支持类装饰器，它们可以修改或增强整个类的行为。类装饰器接收类作为参数，并返回修改后的类：

def singleton_decorator(cls):
    instances = {}
    def get_instance(args, kwargs):
        if cls not in instances:
            instances[cls] = cls(args, kwargs)
        return instances[cls]
    return get_instance

@singleton_decorator
class DatabaseConnection:
    def __init__(self):
        # 初始化数据库连接
        pass

方法装饰器（如@classmethod, @staticmethod）是Python内置的装饰器，用于定义类方法和静态方法，它们改变了方法的行为和调用方式。

装饰器的高级应用与最佳实践

在实际项目中，装饰器常用于实现横切关注点，如日志记录、权限验证、性能监测和缓存等。为了保持装饰器的健壮性，应当使用functools.wraps来保留原始函数的元数据：

from functools import wraps

def log_decorator(func):
    @wraps(func)
    def wrapper(args, kwargs):
        print(f调用函数: {func.__name__})
        result = func(args, kwargs)
        print(f函数 {func.__name__} 执行完毕)
        return result
    return wrapper

使用@wraps确保了装饰后的函数保留了原始函数的名称、文档字符串和其他属性，这对于调试和文档生成至关重要。

装饰器的组合与执行顺序

多个装饰器可以叠加使用，它们的执行顺序是从下往上（或从内往外）。例如：

@decorator_a
@decorator_b
@decorator_c
def my_function():
    pass

实际上等同于：my_function = decorator_a(decorator_b(decorator_c(my_function)))。理解这种执行顺序对于正确使用多个装饰器至关重要，因为前一个装饰器处理的是后一个装饰器返回的函数。