讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

Python 描述符与装饰器的区别与联系

阿雪姑娘_1436

阿雪姑娘_1436

发布时间:2026-02-25 19:49:03

|

313人浏览过

|

来源于php中文网

原创

描述符的 __get__ 和装饰器的 @ 本质不同:描述符是对象协议机制,通过 __get__ 等方法控制属性访问;装饰器是语法糖,本质为函数调用与赋值替换。

python 描述符与装饰器的区别与联系

描述符的 __get__ 和装饰器的 @ 本质不是一回事

描述符是 Python 对象协议层面的机制,靠类定义三个特殊方法(__get__、__set__、__delete__)控制属性访问;装饰器是语法糖,本质是函数调用 + 赋值替换。它们解决的问题域不同:描述符管“怎么取值/赋值”,装饰器管“怎么包装/增强函数或类”。

常见错误现象:Property 被当成装饰器用,结果在类外直接调用 property 实例报 TypeError: 'property' object is not callable;或者把描述符实例误当普通属性赋值,没意识到它必须定义在类级别。

  • property 是内置描述符,但它的 __get__ 只在实例访问时触发,不能当函数直接调用
  • 装饰器如 @lru_cache 作用于函数对象,返回新函数;描述符必须作为类属性存在,不能放在实例上
  • 描述符的绑定行为依赖访问路径:通过实例访问触发 __get__(self, obj, objtype),通过类访问则 obj 为 None

什么时候该用描述符而不是装饰器

当你需要拦截对某个属性的读写逻辑,并且这个逻辑要复用在多个类或多个属性上时,描述符更合适。比如统一做类型校验、懒加载、权限检查、缓存代理——这些都发生在属性访问那一刻,不是函数调用时刻。

典型使用场景:class Config 中多个字段需强制转为 str;class CachedField 封装数据库字段的延迟加载;class ValidatedAttribute 在赋值时校验范围。

立即学习“Python免费学习笔记(深入)”;

Python Hardener
Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖,强化 Python 脚本。

下载
  • 如果逻辑绑定在“属性”上(如 user.name),优先考虑描述符
  • 如果逻辑绑定在“调用”上(如 user.get_profile()),优先用装饰器
  • 描述符无法用于局部变量或函数内变量;装饰器也不能直接修饰实例属性
  • 描述符在类创建时就生效,装饰器在函数定义后立即执行(注意 @decorator 的执行时机)

__set_name__ 是描述符能“知道属性名”的关键

Python 3.6+ 引入 __set_name__,让描述符能在被赋值给类属性时自动获知自己叫什么。没有它,你就得手动传名字,容易出错或冗余。

不加 __set_name__ 的描述符,在多属性复用时会混淆上下文。比如一个 NonNegative 描述符同时用于 age 和 score,若内部靠字符串硬编码找字段名,就完全不可维护。

  • 必须实现 def __set_name__(self, owner, name): self.name = name 才能安全绑定属性名
  • owner 是拥有该描述符的类,可用于检查类型兼容性(比如只允许在 Model 子类中使用)
  • 装饰器没有类似机制——它不关心被装饰对象在类里叫什么,只处理函数对象本身
  • 老版本 Python(

装饰器可以封装描述符,但别反过来

你可以写一个装饰器,自动给类添加描述符属性(比如 @auto_describe 给所有 _ 开头的类变量加上描述符逻辑),这是合理组合;但反过来,用描述符去“模拟”装饰器行为(比如想让属性访问自动触发日志),通常绕路又难调试。

性能差异明显:描述符每次属性访问都走协议方法,有函数调用开销;装饰器只在定义时运行一次,调用时只是普通函数调用(除非装饰器本身做了额外代理)。

  • 示例:用装饰器生成描述符类 @make_descriptor class IntField: 是可行的设计模式
  • 但试图用描述符重写 @staticmethod 或 @classmethod,会破坏协议语义,且无法正确处理 self 绑定
  • 兼容性注意:描述符在 __slots__ 类中仍有效,但装饰器对 __slots__ 无影响
  • 最易忽略的一点:描述符的 __set__ 如果抛异常,会中断赋值;而装饰器抛异常只影响函数调用,不影响对象结构
事情说清了就结束

热门AI工具

更多
码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

相关专题

更多
js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1918

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

3164

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6364

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

6509

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

8034

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

12434

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

6459

2025.07.29

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

7227

2025.08.07

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

0

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn