Python 的描述符到底是个啥?property 和 classmethod 底层都靠它,3 个例子讲透

简介: 描述符不是高深魔法,它就是定义了 __get__ 方法的普通对象。property、classmethod 甚至方法自动绑定 self 底层全是描述符。3 个例子从函数即描述符讲到 property 实现,附对照表与排错清单。

结论先行:描述符(descriptor)不是什么高深魔法,它就是——一个定义了 __get__(可选 __set__/__delete__)方法的普通对象。Python 看到你"用实例去访问一个类属性"时,如果这个类属性是个描述符,就不会原样返回它,而是自动调用它的 __get__。你天天用的 property、classmethod、staticmethod,甚至"方法会自动绑定 self"这件事,底层全是描述符。


1. 先认识:啥样的对象算描述符

规则极简,一个类只要实现了下面三个方法的任意组合,它的实例就是描述符:

实现了什么 叫什么 典型用途
只有 __get__ 非数据描述符 方法、classmethod、staticmethod
__get__ + __set__(或 __delete__) 数据描述符 property、带校验的属性
class Show:
    def __get__(self, instance, owner):
        return '描述符被触发了!'

class Demo:
    x = Show()          # 类属性是个描述符

d = Demo()
print(d.x)              # 描述符被触发了!——注意:不是返回 Show 实例

关键点:d.x 拿到的不再是 Show 实例本身,而是 __get__ 的返回值。访问被"拦截"了——这就是描述符的全部秘密。

2. 最震撼的例子:函数就是描述符

def hello(self):
    return f'hello {self.name}'

print(hasattr(hello, '__get__'))     # True!函数也有 __get__

为什么重要:这解释了一个初学者常问的问题——为什么 obj.method() 会自动传入 obj 当 self? 因为函数是非数据描述符:obj.method 访问时,函数的 __get__ 被调用,返回一个"绑定了 obj 的 bound method"。你不是在调用一个普通函数,你是在调用描述符协议制造出来的绑定方法。classmethod/staticmethod 只是内置的另外两种描述符,改的是 __get__ 的返回逻辑。

3. property 的底层:一个数据描述符

property 本质上就是个数据描述符类,可以徒手复刻:

class MyProperty:
    def __init__(self, fget):
        self.fget = fget
    def __get__(self, instance, owner):
        if instance is None:
            return self
        return self.fget(instance)

class Circle:
    def __init__(self, r):
        self._r = r
    @MyProperty
    def area(self):
        return 3.14 * self._r ** 2

print(Circle(2).area)    # 12.56

对照真 property:内置 property 无非是多带了 fset/fdel,实现了 __set__/__delete__。注意一个推论:**数据描述符优先级高于实例dict**——这就是"为什么你没法用c.area = 100覆盖一个 property"的原因(会进set` 被拦截或报错),而非数据描述符(普通方法)会被实例字典挡住(给实例绑一个同名方法就能"覆盖"类方法)。

4. 实战:写一个"类型强制检查"描述符

class Typed:
    def __init__(self, name, typ):
        self.name = name
        self.typ = typ
    def __get__(self, instance, owner):
        if instance is None:
            return self
        return instance.__dict__[self.name]
    def __set__(self, instance, value):
        if not isinstance(value, self.typ):
            raise TypeError(f'{self.name} 必须是 {self.typ.__name__},拿到 {type(value).__name__}')
        instance.__dict__[self.name] = value

class User:
    name = Typed('name', str)
    age = Typed('age', int)

u = User()
u.name = '张三'      # ok
u.age = '十八'       # TypeError: age 必须是 int,拿到 str

为什么好用:ORM 的字段校验、Django Model、dataclass 的类型约束,底层都是这个模式——描述符把"校验逻辑"从 __init__ 里搬到了类属性上,声明一行就行。

5. 描述符 vs property vs getattr(到底用谁)

维度 描述符 property __getattr__
触发时机 访问类属性时 访问类属性时 正常查找失败后才调用
能拦截赋值 能(__set__) 能 不能(要配 __setattr__)
性能 快(C 层协议) 快 慢(异常路径)
适用 复用校验/计算逻辑 单个属性封装 兜底代理、动态属性

对照结论:逻辑要在多个类/多个属性上复用 → 写描述符;只为一个属性服务 → 直接 property;想"查不到再编一个" → __getattr__。

6. 排错清单(收藏级)

  • 改了 property 却没生效? 检查是不是在实例 __dict__ 里塞了同名键——数据描述符优先级高于实例字典,但如果你写的是非数据描述符(只有 __get__),实例字典会挡住它。
  • __get__ 里 instance 是 None? 那是用类直接访问(Demo.x),记得判空返回自身或做别的处理。
  • 描述符里存状态存错了地方? 存在描述符实例自己身上 = 所有实例共享(经典 bug);必须存 instance.__dict__ 才是每个实例一份。
  • classmethod 为啥拿不到实例? 它也是描述符,__get__ 返回绑定到类的方法——协议不同,不是 bug。

下一篇:《Python 字典为什么查得快?3 个实验看懂哈希表底层》——关注不迷路。

相关文章
|
1月前
|
人工智能 安全 小程序
阿里云服务器199元1年购买与使用常见问题:2核4G5M带宽,续费同价,企业用户专享
阿里云199元/年通用算力型u1实例(ecs.u1-c1m2.large)面向企业实名认证用户,配置2核4G、5Mbps固定公网带宽、80GB ESSD Entry云盘,主打"续费同价",活动延至2029年3月31日,最长可同价使用5年,适合建站、开发测试、后台管理、小程序及跨境出海等通用场景;个人账号无法购买,同一企业主体最多保有一台,适合预算敏感的中小企业长期选用。
|
30天前
|
缓存 JSON API
通义千问Qwen3.7-Flash技术手册:百万级长文档处理、编程能力与API接入教程
综合来看,新版通义千问Qwen3.7‑Flash的核心优势在于百万上下文高速预填充、多模态空间感知、轻量化推理成本,MoE稀疏混合专家架构兼顾模型能力、推理速度与调用开销,适配批量文档处理、代码工程、多模态智能体等高并发业务场景。在实际开发使用时,需要结合业务场景选择是否开启思考模式,合理设计工具描述,做好上下文管理与异常处理,充分发挥模型高速长文本与跨模态推理能力,同时做好Token用量管控,平衡应用效果与调用成本。作为面向高并发业务的高速多模态基座模型,它可以大幅降低大规模智能体应用的开发成本,支撑企业级批量文档分析、自动化智能体项目落地。
216 1
|
30天前
阿里云轻量应用服务器公网流量包:无固定流量,什么意思?
阿里云轻量应用服务器“无固定流量”套餐:流量不限、不额外计费,仅收取固定年费(低至38元/年),含200Mbps带宽;区别于旧版“每月流量”配额套餐,入网流量免费。新用户享68元/年优惠。阿里云轻量应用服务器官网:https://t.aliyun.com/U/dwftch
阿里云Qoder - Teams 国际版300元/席位/月,300元3000Credits
阿里Qoder Credits不足可单独购买:300元/3000 Credits。支持按需充值,无需整席位订阅;团队还可选购共享资源包。详情及购买入口见官网指南👉️ https://t.aliyun.com/U/CpdGPQ
|
1月前
|
存储 弹性计算 固态存储
阿里云服务器租用费用价格:轻量和ECS收费标准,新用户最低38元一年
2026年阿里云服务器最新报价:轻量应用服务器低至38元/年(2核2G+200M带宽),ECS经济型99元/年起;含ECS实例规格、带宽(1–5Mbps月付23–125元)、ESSD云盘等详细计费说明,覆盖个人开发与企业级场景。
|
30天前
|
弹性计算 人工智能 安全
阿里云最新最便宜的云服务器多少钱?目前价格最低的云服务器配置、价格、购买资格及注意事项参考
本文旨在从价格结构、资源配比、适用业务场景、购买资格约束、续费机制与生命周期成本(TCO)等多个维度,对以上三类实例进行系统化的横向对比与深度解析,辅助采购决策者建立严谨的评估框架,在满足当前业务运行基线的同时,为未来架构演进预留合理的成本弹性空间。
|
30天前
|
人工智能 Shell API
DeepSeek Harness上手实战:开源Agent底座完整部署与配置教程
随着大模型技术快速迭代,仅依靠对话API只能完成文本输出,想要让AI具备读写本地文件、执行终端脚本、拆解多步骤复杂任务、调度子智能体的实操能力,就需要Agent运行底座作为支撑。2026年8月开源的DeepSeek Harness(简称DSH),提出Agent = Model + Harness的核心理念,大模型负责思考推理,Harness充当智能体的执行载体,完成环境感知、工具调度、会话生命周期管控、沙箱隔离、任务循环与子Agent调度等工作。项目依托Cordis微内核,贯彻“一切皆插件”的设计思想,模型适配器、工具集、存储组件、Web前端界面全部以插件形式实现,无需修改源码就可以替换组件、
388 0
|
30天前
|
自然语言处理 IDE Java
IDEA 2026.3 EAP新特性:终于要向“包名对不上文件夹”的代码低头了
IntelliJ IDEA 2026.3 EAP新增特性:支持包名与目录结构不一致时的通配符导入(如`import org.classa.*`)。不再强求目录匹配包名,而是依据类声明的全限定名进行符号解析,使遗留、脚本化或非标准项目中的导入正常高亮与补全,真正让工具适配真实代码。(239字)
153 0
|
1月前
|
存储 人工智能 自然语言处理
阿里企业邮箱收费标准:标准版、AI尊享版和国产化版费用清单,2026年最新整理
阿里云企业邮箱提供免费版(0元)及三类付费版:标准版600元/年(适合初创企业)、AI尊享版720元/年(含AI写信、翻译、智能标签等)、国产化版900元/年(适配信创环境,满足政企合规要求)。
381 0
|
1月前
|
存储 弹性计算 人工智能
2026 年零成本上云全攻略:阿里云免费云服务器申领流程、资源解析与意外扣费处理方案
对于个人开发者、在校学生以及初创小团队来说,云平台的免费试用资源是降低技术学习成本、开展项目原型验证、测试业务功能的重要途径。阿里云开放了数量庞大的免费云产品权益,覆盖计算、存储、数据库、网络、安全、AI开发等上百款产品,很多新手在初次接触的时候,常常搞不清楚哪些资源真正免费、领取需要满足什么条件、如何正确操作,同时还会踩到期自动扣费、资源超量产生账单等各类问题。本文将从权益基础认知、领取完整流程、各类免费资源深度解析、命令行实操、额度监控、避坑方案以及高频问题排查等多个维度,完整拆解阿里云免费云服务器与免费云产品的全部使用逻辑,帮助使用者真正做到零成本体验云能力,同时规避不必要的账单风险。
277 0

热门文章

最新文章