Python 装饰器详解：从入门到精通的完整指南
# Python 装饰器详解：从入门到精通的完整指南
## 什么是装饰器？
装饰器（Decorator）是 Python 中一种强大的工具，它允许我们在不修改原函数代码的情况下，动态地添加功能。简单来说，装饰器就是一个**返回函数的函数**。
## 基础语法
装饰器使用 `@` 符号语法，放在函数定义之前：
```python
def my_decorator(func):
def wrapper():
print("函数执行前")
func()
print("函数执行后")
return wrapper
@my_decorator
def say_hello():
print("Hello!")
say_hello()
# 输出:
# 函数执行前
# Hello!
# 函数执行后
```
## 带参数的装饰器
实际开发中，我们经常需要处理带参数的函数：
```python
def my_decorator(func):
def wrapper(*args, **kwargs):
print("函数执行前")
result = func(*args, **kwargs)
print("函数执行后")
return result
return wrapper
@my_decorator
def greet(name, age):
print(f"姓名：{name}, 年龄：{age}")
return "完成"
result = greet("张三", 25)
```
## 实用案例：计时装饰器
```python
import time
from functools import wraps
def timer_decorator(func):
@wraps(func)
def wrapper(*args, **kwargs):
start = time.time()
result = func(*args, **kwargs)
end = time.time()
print(f"{func.__name__} 执行时间：{end - start:.4f}秒")
return result
return wrapper
@timer_decorator
def slow_function():
time.sleep(1)
print("任务完成")
slow_function()
```
## 实用案例：日志装饰器
```python
from functools import wraps
import logging
logging.basicConfig(level=logging.INFO)
def log_decorator(func):
@wraps(func)
def wrapper(*args, **kwargs):
logging.info(f"调用 {func.__name__}, 参数：{args}, {kwargs}")
result = func(*args, **kwargs)
logging.info(f"{func.__name__} 返回：{result}")
return result
return wrapper
@log_decorator
def add(a, b):
return a + b
add(3, 5)
```
## 带参数的装饰器
```python
def repeat(times):
def decorator(func):
@wraps(func)
def wrapper(*args, **kwargs):
for _ in range(times):
result = func(*args, **kwargs)
return result
return wrapper
return decorator
@repeat(3)
def greet(name):
print(f"Hello, {name}!")
greet("World")
```
## 类装饰器
装饰器不仅可以是函数，也可以是类：
```python
class CountCalls:
def __init__(self, func):
self.func = func
self.count = 0
def __call__(self, *args, **kwargs):
self.count += 1
print(f"第 {self.count} 次调用")
return self.func(*args, **kwargs)
@CountCalls
def say_hello():
print("Hello!")
say_hello()
say_hello()
```
## 多个装饰器
一个函数可以使用多个装饰器：
```python
def decorator1(func):
def wrapper(*args, **kwargs):
print("装饰器 1")
return func(*args, **kwargs)
return wrapper
def decorator2(func):
def wrapper(*args, **kwargs):
print("装饰器 2")
return func(*args, **kwargs)
return wrapper
@decorator1
@decorator2
def hello():
print("Hello!")
hello()
# 输出顺序：装饰器 2 → 装饰器 1 → Hello!
```
## 最佳实践
1. **使用 `@wraps`**：保留原函数的元信息
2. **保持装饰器简洁**：一个装饰器只做一件事
3. **处理异常**：在装饰器中妥善处理异常
4. **文档化**：为装饰器添加清晰的文档说明
## 总结
装饰器是 Python 中的高级特性，掌握它可以让你写出更优雅、更可维护的代码。从简单的日志记录到复杂的权限控制，装饰器的应用场景非常广泛。
---
_希望这篇文章能帮助你更好地理解和使用 Python 装饰器！_