Python 装饰器详解 | 极客日志

Python

Python 装饰器详解

Python 装饰器是一种在不修改原函数代码前提下扩展功能的机制。核心是接收函数并返回新函数。常见类型包括普通函数装饰器、带参装饰器及类装饰器。内置装饰器如@property、@classmethod 和@staticmethod 也广泛应用。实际场景中，装饰器常用于日志记录、性能计时及权限校验，能显著减少重复代码，提升维护效率。通过@语法糖可简化调用，配合 functools.wraps 保留元数据更佳。掌握装饰器有助于编写更优雅、模块化的 Python 代码。

栈溢出发布于 2026/3/210 浏览

Python 装饰器详解

基本概念

装饰器本质上是一个接受函数作为参数并返回一个新函数的函数。它的核心作用是在不修改原函数代码的前提下，为函数添加额外的功能。

打个比方，你有一个杯子（礼物）想要送人，光送杯子可能显得单调，所以找个礼物盒（装饰器）把它装进去。这个盒子对杯子而言只是起到装饰作用，不会改变杯子盛水的功能。在 Python 中，我们可以用 A 函数对 B 函数添加功能，同时保持 B 函数代码不变，这时 A 函数就是装饰器。

先看一个普通函数：

def say_hello():
    print("你好！")

say_hello()
# 输出：你好！

假如我们想在说'你好'之前和之后都加上一些提示语句，传统做法是修改原函数，但有了装饰器就不需要了。

def decorator(func):
    def wrapper():
        print("准备开始啦！")
        func()  # 调用原函数
        print("结束啦！")
    return wrapper

def say_hello():
    print("你好！")

# 给函数「加上装饰」
decorated_say_hello = decorator(say_hello)
decorated_say_hello()
# 输出结果
# 准备开始啦！
# 你好！
# 结束啦！

通过上面的例子可以看到，decorator 接收了 func 参数，最终返回了 wrapper 函数，这就是'接受函数作为参数并返回一个新函数'的体现。

很多人对嵌套函数形式不太理解，其实逻辑很简单：decorator 是包装纸，wrapper 是包裹后的新对象，而原函数是被装饰的苹果。使用 @ 符号可以简化这种写法：

def decorator(func):
    def wrapper():
        print("准备开始啦！")
        func()
        print("结束啦！")
    return wrapper


 ():
    ()

say_hello()

def say_hello_machine(func):
    def wrapper():
        print("你好！")  # 加上的'巧克力酱'
        func()            # 原来的圆筒冰淇淋
        print("再见！")   # 加上的'坚果碎'
    return wrapper

@say_hello_machine
def my_name():
    print("我是小明")

my_name()
# 输出结果
# 你好！
# 我是小明
# 再见！

def say_hello_machine_times(times):
    def real_decorator(func):
        def wrapper():
            for i in range(times):
                print("你好！")
            func()
        return wrapper
    return real_decorator

@say_hello_machine_times(3)
def my_name():
    print("我是小明")

my_name()
# 输出结果
# 你好！
# 你好！
# 你好！
# 我是小明

class MyDecorator:
    def __init__(self, func):
        self.func = func

    def __call__(self):
        print("类装饰器说：开始！")
        self.func()
        print("类装饰器说：结束！")

@MyDecorator
def my_name():
    print("我是小明")

my_name()
# 输出结果
# 类装饰器说：开始！
# 我是小明
# 类装饰器说：结束！

class Circle:
    def __init__(self, radius):
        self.radius = radius

    @property
    def area(self):
        return self.radius * self.radius * 3.14

circle = Circle(10)
print(circle.area)  # 直接当属性用，不用加括号！
# 输出：314.0

class ThirdGradeClass:
    total_students = 0

    def __init__(self, name):
        self.name = name
        ThirdGradeClass.total_students += 1

    @classmethod
    def get_total_students(cls):
        return cls.total_students

xiaoming = ThirdGradeClass("小明")
xiaohong = ThirdGradeClass("小红")
print(ThirdGradeClass.get_total_students())  # 输出：2

class ThirdGradeClass:
    @staticmethod
    def add_numbers(a, b):
        return a + b

result = ThirdGradeClass.add_numbers(5, 3)
print(result)  # 输出：8

def log_action(func):
    def wrapper():
        print(f"记录：玩家进行了 {func.__name__} 操作！")
        func()
    return wrapper

@log_action
def build_house():
    print("砰！砰！砰！一栋房子盖好了！")

@log_action
def mine_ore():
    print("镐子咣咣咣，挖到了钻石！")

build_house()
mine_ore()

import time

def timer(func):
    def wrapper():
        start_time = time.time()
        func()
        end_time = time.time()
        print(f"【{func.__name__}】动作耗时：{end_time - start_time:.2f} 秒")
    return wrapper

@timer
def chop_tree():
    print("咔嚓...咔嚓...")
    time.sleep(2)
    print("获得木头*5！")

chop_tree()

player_level = 8

def check_level(required_level):
    def decorator(func):
        def wrapper():
            if player_level >= required_level:
                func()
            else:
                print(f"权限不足！需要 {required_level} 级，你只有 {player_level} 级。")
        return wrapper
    return decorator

@check_level(required_level=10)
def use_ender_chest():
    print("成功打开末影箱，存取物品！")

use_ender_chest()