当前位置：首页>python>Python 装饰器到底是什么?从函数对象、闭包到实战代码完整拆解

Python 装饰器到底是什么?从函数对象、闭包到实战代码完整拆解

2026-08-18 23:11:33

PYTHON TUTORIAL

Python 装饰器到底是什么？从函数对象、闭包到实战代码完整拆解

看懂函数如何被包装、替换与增强，掌握日志、计时、重试和权限检查的通用写法。

先从一个常见疑问开始

很多人在开展 Python 学习的时候，第一次看到函数上方出现 @timer、@retry 或者 @login_required 这样的代码，往往都会产生一个比较直接的疑问：这究竟属于什么样的特殊语法？为什么只是在原有函数的上方增加一行代码，就能够让这个函数拥有运行时间统计、失败重试、日志记录以及权限检查等多个方面的能力？

这篇内容会讲清楚

01　函数对象与闭包为什么是装饰器的基础

02　wrapper 如何在不改原函数的前提下扩展能力

03　实战场景、常见错误与多层装饰顺序

01 / FOUNDATION

先理解函数对象与闭包

装饰器成立的前提，是函数可以被赋值、传参和返回。

实际上，Python 装饰器并不是什么难以理解的魔法功能。它在本质方面的逻辑相对比较简单，也就是接收一个函数，然后在原有函数的基础上返回一个经过包装之后的新函数。

在正式理解装饰器之前，需要先明确 Python 函数所具有的一个重要特性：在 Python 语言当中，函数本身也是一种对象。函数不仅能够像平常一样被调用，同时还可以赋值给变量、作为参数传递给其他函数，也能够作为另外一个函数的返回结果进行使用。

例如，可以先定义一个 greet 函数，然后把它赋值给 say_hello 变量。即便后续通过 say_hello() 的方式开展调用，仍然能够执行原来 greet 函数当中的相关逻辑。这说明变量保存的并不是函数执行之后的结果，而是对函数对象本身的引用。

在理解函数可以被传递之后，再去观察闭包的相关概念，往往就会容易很多。所谓闭包，主要是指内部函数引用了外部函数作用域当中的变量，并且在外部函数已经执行结束之后，内部函数仍然可以继续访问以及使用这些变量。

装饰器之所以能够实现函数能力的扩展，正是因为同时利用了两个方面的特性：一方面，函数对象可以作为参数进行传递；另一方面，闭包可以保存外部函数作用域当中的相关状态。

KEY POINT

函数可以传递，闭包可以保存状态，这两点共同构成了装饰器的基础。

02 / MECHANISM

装饰器的本质：替换函数引用

先看一段基础代码，再拆开 @decorator 背后的等价过程。

下面这段代码，就是一个相对基础的装饰器示例：

•••python

from functools import wraps

def log_call(func):

　@wraps(func)

　def wrapper(*args, **kwargs):

　　print(f"开始调用：{func.__name__}")

　　result = func(*args, **kwargs)

　　print(f"调用结束：{func.__name__}")

　　return result

　return wrapper

在这段代码当中，log_call 函数会接收一个名为 func 的函数对象。它的内部又定义了一个 wrapper 包装函数，用来在原函数执行之前以及执行之后，分别增加相对应的日志输出逻辑。

wrapper 使用了 *args 和 **kwargs 来接收参数，这样就能够适配不同参数形式的函数，而不需要提前把参数数量以及参数名称全部写死。在调用原函数之后，还需要把执行结果保存到 result 当中，并且在最后将这个结果重新返回出去。

当我们写下下面这样的代码时：

•••python

@log_call

def add(a, b):

　return a + b

它在实际执行逻辑方面，基本等价于下面这种写法：

•••python

def add(a, b):

　return a + b

add = log_call(add)

也就是说，原来的 add 函数首先会被作为参数传递给 log_call。随后，log_call返回内部定义的 wrapper 函数，并且变量 add 会重新指向这个已经经过包装的新函数。

03 / CALL FLOW

wrapper 如何接管一次函数调用

被装饰后的函数先进入包装层，再由包装层调用原函数。

因此，当后续调用 add(2, 3) 的时候，程序并不会直接进入原来的加法函数，而是会先进入 wrapper。包装函数首先执行原函数调用之前的日志逻辑，然后通过 func(*args, **kwargs)调用最开始定义的 add 函数，接着执行调用结束后的相关逻辑，最后再把原函数返回的计算结果传递出去。

从这个过程可以看出，装饰器并没有直接修改原函数内部的代码，而是在原函数外部增加了一层包装。这样就能够在不改变原有业务逻辑的情况下，为多个函数统一增加相对应的功能。

1进入包装函数

先执行原函数调用之前的额外逻辑。

2调用原函数

通过 func(*args, **kwargs) 传入原始参数。

3完成后置逻辑并返回

执行调用结束后的逻辑，并把原函数结果继续传出去。