Python装饰器系统学习路线第526讲_核心原理与实战案例详解【教程】_网络技术

装饰器本质是函数替换，定义时立即执行并覆盖原函数；带参装饰器需三层结构；必须用@wraps保留元信息；类装饰器适用于需状态管理的场景。

@decorator 的本质是函数替换，不是语法糖包装——它在被装饰函数定义时就立即执行，返回值直接覆盖原函数名指向的对象。

装饰器执行时机：定义时而非调用时

很多人误以为 @log_calls 是在 my_func() 被调用时才触发日志逻辑，其实不然。装饰器在模块加载、函数对象创建后**立刻运行**，my_func 这个名字绑定的已经是装饰器返回的新函数了。

验证方式：

def log_calls(func):
    print(f"[DEBUG] Decorating {func.__name__}")
    def wrapper(*args, **kwargs):
        print(f"→ Calling {func.__name__}")
        return func(*args, **kwargs)
    return wrapper
@log_calls
def add(a, b):
return a + b
输出：[DEBUG] Decorating add
此时 add 已是 wrapper，不是原始函数

常见错误：在装饰器里写耗时初始化（如连接数据库），却没意识到它会在导入模块时就执行，导致启动变慢或连接失败。

带参数的装饰器必须是三层函数

@retry(max_attempts=3) 看似带参，实则是「装饰器工厂」：外层函数接收参数，返回真正的装饰器（第二层），再由它接收被装饰函数（第三层）。

第一层：retry(max_attempts=3) → 返回一个装饰器函数
第二层：返回的装饰器接收 func → 返回包装函数
第三层：包装函数处理实际调用逻辑

漏掉任意一层都会报错：TypeError: 'int' object is not callable 或 missing 1 required positional argument: 'func'。

def retry(max_attempts=2):
    def decorator(func):  # ← 第二层：真正装饰器
        def wrapper(*args, **kwargs):
            for i in range(max_attempts):
                try:
                    return func(*args, **kwargs)
                except Exception as e:
                    if i == max_attempts - 1:
                        raise
        return wrapper
    return decorator  # ← 必须返回 decorator，不能直接 return wrapper

functools.wraps 是为了保留元信息，不是可选项

不加 @wraps(func)，被装饰函数的 __name__、__doc__、__annotations__ 全部变成包装函数的（比如 wrapper），这对调试、IDE 提示、文档生成（Sphinx）、类型检查（mypy）都是硬伤。

典型现象：

help(add) 显示的是 wrapper 的帮助，不是 add 的
Flask 路由函数名丢失，导致 url_for('add') 找不到端点
pytest 收集测试函数时跳过，因为 test_add.__name__ 变成 wrapper

from functools import wraps
def log_calls(func):
@wraps(func)  # ← 关键：把 func 的 name、doc 等复制给 wrapper
def wrapper(*args, *kwargs):
print(f"Calling {func.name}")
return func(args, **kwargs)
return wrapper

类装饰器：当状态管理或复杂配置成为刚需

函数装饰器适合无状态逻辑（如日志、计时），但遇到需要跨调用保存状态（如统计调用次数、缓存最近 N 次结果）、或需复用配置时，类更自然。

注意点：

类必须实现 __call__ 方法，否则 @MyDecorator 会报 TypeError: 'MyDecorator' object is not callable
类实例在装饰时创建一次，所有对该函数的调用共享该实例状态
若需每个被装饰函数独立状态，得在 __init__ 中按 func 做隔离（如用 weakref.WeakKeyDictionary）

class CallCounter:
    def __init__(self, func):
        self.func = func
        self.count = 0
        # 用 wraps 保持原函数信息
        from functools import wraps
        self.__wrapped__ = func
        wraps(func)(self)
def __call__(self, *args, **kwargs):
    self.count += 1
    print(f"{self.func.__name__} called {self.count} times")
    return self.func(*args, **kwargs)
@CallCounter
def say_hello():
return "hello"
类装饰器的 __init__ 和 __call__ 分离清晰，但容易忽略 __wrapped__ 和 @wraps 的配合，导致调试时找不到原始函数。
装饰器最易出问题的地方不在语法，而在执行时序和对象生命周期——它改写的是函数定义那一刻的命名空间绑定，不是调用栈里的某个环节。写完记得检查 my_func.name 和 my_func.code.co_filename 是否如预期。
          


# python 
# app 
# 栈 
# ai 
# 路由 
# red 
 




相关栏目：
    【
        网站优化151355    】
    【
        网络推广146373    】
    【
        网络技术251813    】
    【
        AI营销90571    】




相关推荐：
Laravel中Service Container是做什么的_Laravel服务容器与依赖注入核心概念解析 
android nfc常用标签读取总结 
*服务器网站为何频现安全漏洞？ 
Linux后台任务运行方法_nohup与&使用技巧【技巧】 
html5audio标签播放结束怎么触发事件_onended回调方法【教程】 
 在线ppt制作网站有哪些软件,如何把网页的内容做成ppt？ 
Laravel的.env文件有什么用_Laravel环境变量配置与管理详解 
 北京的网站制作公司有哪些,哪个视频网站最好？ 
再谈Python中的字符串与字符编码（推荐） 
Win11怎么查看显卡温度 Win11任务管理器查看GPU温度【技巧】 
如何用5美元大硬盘VPS安全高效搭建个人网站？ 
Laravel如何编写单元测试和功能测试？（PHPUnit示例） 
如何选择PHP开源工具快速搭建网站？ 
Midjourney怎么调整光影效果_Midjourney光影调整方法【指南】 
如何用好域名打造高点击率的自主建站？ 
深入理解Android中的xmlns:tools属性 
如何用PHP快速搭建高效网站？分步指南 
javascript事件捕获机制【深入分析IE和DOM中的事件模型】 
ChatGPT怎么生成Excel公式_ChatGPT公式生成方法【指南】 
Laravel辅助函数有哪些_Laravel Helpers常用助手函数大全 
如何在 Telegram Web View（iOS）中防止键盘遮挡底部输入框 
香港服务器建站指南：免备案优势与SEO优化技巧全解析 
Laravel API路由如何设计_Laravel构建RESTful API的路由最佳实践 
Laravel如何设置自定义的日志文件名_Laravel根据日期或用户ID生成动态日志【技巧】 
企业网站制作这些问题要关注 
Laravel如何使用Scope本地作用域_Laravel模型常用查询逻辑封装技巧【手册】 
 胶州企业网站制作公司,青岛石头网络科技有限公司怎么样？ 
Laravel如何实现密码重置功能_Laravel密码找回与重置流程 
关于BootStrap modal 在IOS9中不能弹出的解决方法(IOS 9 bootstrap modal ios 9 noticework) 
Laravel怎么上传文件_Laravel图片上传及存储配置 
Laravel如何集成第三方登录_Laravel Socialite实现微信QQ微博登录 
Laravel如何创建和注册中间件_Laravel中间件编写与应用流程 
 网站制作公司哪里好做,成都网站制作公司哪家做得比较好，更正规？ 
如何批量查询域名的建站时间记录？ 
用v-html解决Vue.js渲染中html标签不被解析的问题 
VIVO手机上del键无效OnKeyListener不响应的原因及解决方法 
Laravel如何部署到服务器_线上部署Laravel项目的完整流程与步骤 
 电视网站制作tvbox接口,云海电视怎样自定义添加电视源？ 
夸克浏览器网页跳转延迟怎么办 夸克浏览器跳转优化 
Windows驱动无法加载错误解决方法_驱动签名验证失败处理步骤 
如何在服务器上配置二级域名建站？ 
Laravel怎么为数据库表字段添加索引以优化查询 
Laravel如何创建自定义中间件？（Middleware代码示例） 
谷歌浏览器如何更改浏览器主题 Google Chrome主题设置教程 
Laravel如何使用Service Provider注册服务_Laravel服务提供者配置与加载 
如何在云主机快速搭建网站站点？ 
 无锡营销型网站制作公司,无锡网选车牌流程？ 
 北京专业网站制作设计师招聘,北京白云观官方网站？ 
JavaScript数据类型有哪些_如何准确判断一个变量的类型 
Laravel怎么返回JSON格式数据_Laravel API资源Response响应格式化【技巧】