深度解析Python装饰器常见用法与进阶技巧

 更新时间:2025年06月25日 14:53:36   作者:天天进步2015  
Python 装饰器(Decorator)是提升代码可读性与复用性的强大工具,本文将深入解析 Python 装饰器的原理,常见用法,进阶技巧与最佳实践,希望可以帮助大家写出更具专业水准的 Python 代码

装饰器的基本原理

装饰器本质上是一个高阶函数,即:以函数为参数并返回新函数的函数。它可以在不修改原始函数代码的前提下,动态地为其添加功能。

def my_decorator(func):
    def wrapper(*args, **kwargs):
        print('Before function call')
        result = func(*args, **kwargs)
        print('After function call')
        return result
    return wrapper

@my_decorator
def say_hello():
    print('Hello, world!')

say_hello()

输出:

Before function call
Hello, world!
After function call

函数装饰器的常见用法

1.日志记录

import logging

def log_decorator(func):
    def wrapper(*args, **kwargs):
        logging.info(f'Calling {func.__name__}')
        return func(*args, **kwargs)
    return wrapper

2.权限校验

def require_admin(func):
    def wrapper(user, *args, **kwargs):
        if not user.is_admin:
            raise PermissionError('Admin required')
        return func(user, *args, **kwargs)
    return wrapper

3.性能分析

import time

def timeit(func):
    def wrapper(*args, **kwargs):
        start = time.time()
        result = func(*args, **kwargs)
        end = time.time()
        print(f'{func.__name__} took {end - start:.4f}s')
        return result
    return wrapper

4.缓存机制

from functools import lru_cache

@lru_cache(maxsize=128)
def fib(n):
    return n if n < 2 else fib(n-1) + fib(n-2)

带参数的装饰器

带参数的装饰器需要再包一层函数:

def repeat(times):
    def decorator(func):
        def wrapper(*args, **kwargs):
            for _ in range(times):
                result = func(*args, **kwargs)
            return result
        return wrapper
    return decorator

@repeat(3)
def greet():
    print('Hello!')

类装饰器与方法装饰器

类装饰器

可以用于增强类的功能:

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

@singleton
class Database:
    pass

方法装饰器

与函数装饰器类似,但要注意 self 的传递:

def method_logger(func):
    def wrapper(self, *args, **kwargs):
        print(f'Calling {func.__name__} of {self}')
        return func(self, *args, **kwargs)
    return wrapper

class MyClass:
    @method_logger
    def foo(self):
        print('foo called')

装饰器的嵌套与组合

多个装饰器可以叠加使用,执行顺序为自下而上:

@decorator_a
@decorator_b
def func():
    pass
# 等价于 func = decorator_a(decorator_b(func))

进阶技巧:保留元信息与类型提示

装饰器会改变被装饰函数的元信息(如__name__, __doc__),推荐用 functools.wraps 保留原信息:

from functools import wraps

def my_decorator(func):
    @wraps(func)
    def wrapper(*args, **kwargs):
        return func(*args, **kwargs)
    return wrapper

对于类型提示,可以直接在装饰器和被装饰函数中添加 type hints。

装饰器最佳实践

  • 始终使用 functools.wraps 保留函数元信息
  • 为装饰器编写单元测试,确保功能可复用且无副作用
  • 合理使用装饰器,避免过度嵌套导致调试困难
  • 利用标准库装饰器(如 @staticmethod, @classmethod, @property, @lru_cache)提升开发效率
  • 为装饰器添加类型提示和文档字符串

总结

Python 装饰器让我们以声明式、可复用的方式增强函数和类的行为。掌握装饰器的原理与用法,不仅能提升代码的可读性和复用性,更能让你的 Python 项目更具专业水准。建议在实际开发中多加练习,灵活运用装饰器解决实际问题。

到此这篇关于深度解析Python装饰器常见用法与进阶技巧的文章就介绍到这了,更多相关Python装饰器内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Python中self关键字的用法解析

    Python中self关键字的用法解析

    在Python中,self是一个经常出现的关键字,特别是在类定义中的方法,这篇文章主要和大家self的作用和用法,希望可以帮助大家更好地理解为什么需要它以及如何正确使用它
    2023-11-11
  • 详解Python的Django框架中的中间件

    详解Python的Django框架中的中间件

    这篇文章主要介绍了详解Python的Django框架中的中间件,包括中间件的安装等内容,需要的朋友可以参考下
    2015-07-07
  • Python中使用Beautiful Soup库的超详细教程

    Python中使用Beautiful Soup库的超详细教程

    这篇文章主要介绍了Python中使用Beautiful Soup库的超详细教程,示例代码基于Python2.x版本,极力推荐!需要的朋友可以参考下
    2015-04-04
  • 手把手教你Python yLab的绘制折线图的画法

    手把手教你Python yLab的绘制折线图的画法

    这篇文章主要介绍了手把手教你Python yLab的绘制折线图的画法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-10-10
  • Python批量处理图片大小尺寸方法详解

    Python批量处理图片大小尺寸方法详解

    这篇文章主要介绍了用Python批量处理图片大小尺寸的方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习吧
    2022-11-11
  • Django自带用户认证系统使用方法解析

    Django自带用户认证系统使用方法解析

    这篇文章主要介绍了Django自带用户认证系统使用方法解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-11-11
  • python实现aes加密及pycryptodome库使用

    python实现aes加密及pycryptodome库使用

    AES算法是高级加密标准,它是一种对称加密算法,AES只有一个密钥,这个密钥既用来加密,也用于解密,这篇文章主要给大家介绍了关于python实现aes加密及pycryptodome库使用的相关资料,需要的朋友可以参考下
    2023-10-10
  • 使用Python将Markdown文件转换为Word的三种方法

    使用Python将Markdown文件转换为Word的三种方法

    在当今的文档处理中,Markdown因其简洁的语法和易读性而广受欢迎,而Microsoft Word则因其广泛的兼容性和专业的排版效果成为商业文档的标准,所以本文将给大家介绍使用Python将Markdown文件转换为Word的三种方法,需要的朋友可以参考下
    2025-04-04
  • 使用python爬取抖音app视频的实例代码

    使用python爬取抖音app视频的实例代码

    这篇文章主要介绍了使用python爬取抖音app视频的实例代码,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-12-12
  • python基础详解之if循环语句

    python基础详解之if循环语句

    这篇文章主要介绍了python基础详解之if循环语句,文中有非常详细的代码示例,对正在学习python的小伙伴们有很好的帮助需要的朋友可以参考下
    2021-04-04

最新评论