Python 内置装饰器全解析

class AgentConfig:
    def __init__(self, temperature: float):
        self._temperature = temperature
    @property
    def temperature(self):
        """读取时像访问属性一样：config.temperature"""
        return self._temperature
    @temperature.setter
    def temperature(self, value: float):
        """设置参数时自动做范围校验"""
        if not 0 <= value <= 2:
            raise ValueError("temperature 必须在 0~2 之间")
        self._temperature = value

config = AgentConfig(0.7)
print(config.temperature)  # 像属性一样读取，不用写 get_temperature()
config.temperature = 1.5  # 像属性一样赋值，自动触发校验逻辑

class AgentConfig:
    @staticmethod
    def validate_temperature(value: float) -> bool:
        """独立的参数校验工具，和实例/类无关"""
        return 0 <= value <= 2
# 直接通过类调用，无需创建实例
print(AgentConfig.validate_temperature(0.7))  # True

from dataclasses import dataclass
from typing import Optional
@dataclass
class SearchResult:
    title: str
    url: str
    snippet: str
    score: Optional[float] = None
# 直接使用，无需手动写构造函数
result = SearchResult(
    title="华为最新手机",
    url="https://example.com",
    snippet="Mate 70 系列发布"
)
print(result)
# SearchResult(title='华为最新手机', url='https://example.com', snippet='Mate 70 系列发布', score=None)

import time
from functools import wraps
def timer(func):
    @wraps(func)  # 保留原函数的元信息
    def wrapper(*args, **kwargs):
        start = time.time()
        result = func(*args, **kwargs)
        print(f"{func.__name__} 耗时: {time.time()-start:.2f}s")
        return result
    return wrapper
@timer
def search(query: str):
    """搜索函数"""
    time.sleep(0.1)
    return f"搜索结果: {query}"
print(search.__name__)  # 保留原函数名：search（不加wraps会变成wrapper）
print(search.__doc__)   # 保留原文档：搜索函数

from functools import lru_cache
@lru_cache(maxsize=100)  # 最多缓存100个结果
def search_web(query: str) -> str:
    """模拟网络搜索，相同query不会重复请求"""
    print(f"执行真实搜索: {query}")
    return f"{query} 的搜索结果"
# 第一次调用会执行真实搜索
search_web("华为最新手机")
# 第二次相同输入，直接返回缓存，不会再打印"执行真实搜索"
search_web("华为最新手机")

from contextlib import contextmanager
import time
@contextmanager
def timer(name: str):
    start = time.time()
    yield  # 进入上下文执行代码，yield 之后是退出逻辑
    print(f"{name} 总耗时: {time.time()-start:.2f}s")
# 使用方式
with timer("搜索流程"):
    time.sleep(0.2)