Apply a named output style to …

# Python装饰器小白学习指南 🐍

一、装饰器是什么？（通俗理解）

装饰器本质上就是一个函数，它接收一个函数，返回一个新函数。打个比方：

• 你写好了一个“原味奶茶”（原函数）
• 装饰器就是“加珍珠、加奶盖”的操作
• 奶茶本体没变，但功能被“装饰”增强了

装饰器用 @装饰器名 放在函数上方，可以在不修改原函数代码的情况下给它增加新功能（如计时、日志、权限检查等）。

二、三个由浅入深的例子

例1：最简版——感受装饰器的基本形式

```python

def say_hi(func):

def wrapper():

print("===== 函数开始 =====")

func()

print("===== 函数结束 =====")

return wrapper

@say_hi

def hello():

print("你好，世界！")

hello()

```

运行效果：先打印分隔线，再打印“你好，世界！”，最后再打印分隔线。

👉 @say_hi 相当于执行了 hello = say_hi(hello)。

例2：处理带参数的函数

```python

def logger(func):

def wrapper(*args, **kwargs): # 接收任意参数

print(f"正在调用函数：{func.__name__}，参数：{args}")

result = func(*args, **kwargs)

print(f"函数执行完毕")

return result

return wrapper

@logger

def add(a, b):

return a + b

add(3, 5)

```

要点：*args, **kwargs 让装饰器适配任何参数签名，实际开发中必写。

例3：实用进阶——函数运行计时器

```python

import time

import functools

def timer(func):

@functools.wraps(func) # 保留原函数的名字和文档信息

def wrapper(*args, **kwargs):

start = time.time()

result = func(*args, **kwargs)

cost = time.time() - start

print(f"{func.__name__} 耗时约 {cost:.2f} 秒")

return result

return wrapper

@timer

def heavy_work():

time.sleep(1)

print("干完活了！")

heavy_work()

```

要点：@functools.wraps 是规范写法，避免原函数名等信息被覆盖。

三、学习要点小结

• 装饰器 = 高阶函数（接收函数、返回函数）
• 核心套路：外层接函数 → 内层 wrapper 增强 → 返回 wrapper
• *args, **kwargs 处理参数，return 保留返回值
• 常见应用：日志、计时、缓存、权限校验、重试机制

建议练习：自己写一个“打印函数被调用次数”的装饰器，写出来就基本入门了！