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月前
|
Linux iOS开发 Python
Python 虚拟环境到底怎么选?venv / conda / pipenv / poetry 一张对比表 + 9 个真实踩坑
venv、conda、pipenv、poetry 到底怎么选?本文用一张对比表 + 9 个真实踩坑讲清楚:什么时候 venv 就够了、什么时候必须上 poetry、conda 真正解决的是什么问题,以及虚拟环境里最常见的路径与依赖冲突该怎么排查。
|
存储 网络协议 安全
DNS科普系列: DNS防火墙(DNS Firewall)
DNS防火墙是一种网络安全解决方案,可以防止网络用户和系统链接到已知的恶意网络位置,可以有效的预防威胁发生, 阻止访问受感染的站点,进而防止进一步的威胁。能够主动检测到已被感染的系统,并通过安全报告的形式将此类威胁通知用户。还能够保护用户的网络环境,提高网络安全性。
DNS科普系列: DNS防火墙(DNS Firewall)
阿里云轻量应用服务器公网流量包:无固定流量,什么意思?
阿里云轻量应用服务器“无固定流量”套餐:流量不限、不额外计费,仅收取固定年费(低至38元/年),含200Mbps带宽;区别于旧版“每月流量”配额套餐,入网流量免费。新用户享68元/年优惠。阿里云轻量应用服务器官网:https://t.aliyun.com/U/dwftch
|
1月前
|
弹性计算 人工智能 运维
2026年阿里云优惠活动大全:怎么便宜买云服务器?新用户云产品折扣详解
总结选购思路:个人建站、新手学习,优先轻量应用服务器;业务需要自定义网络、后续有扩容需求,选择ECS;AI模型训练场景,选择GPU云服务器。参与2026年阿里云优惠活动,先完成实名,进入新客专区领取代金券,结合业务周期选择计费方式,下单前用CLI命令核对价格,部署完成后用基础运维命令监控服务器状态。合理利用新用户折扣,匹配业务需求挑选实例,能够大幅降低上云初期成本。
187 2
|
1月前
|
设计模式 缓存 安全
Agent Harness 深度拆解:从一个类比推导出 12 个组件
本文另辟蹊径,不罗列12个组件,而是以“裸LLM=无内存/硬盘/I/O的CPU”为心智模型,用第一性原理推导出长周期任务必然引发的5大问题(上下文腐化、错误累积、跨会话失忆、权限越界、无法自验),再逐一对映12个组件为何必然存在——讲清Harness不是设计模式,而是必须跑起来的运行时系统。(239字)
|
1月前
|
弹性计算 人工智能 安全
阿里云部署 DeepSeek Harness 开源智能体:获取百炼 API‑Key 到 WebUI 配置全流程
本方案介绍如何通过阿里云计算巢一键部署DeepSeek Harness——一款由DeepSeek AI开源的“一切皆插件”智能体框架,基于Cordis引擎,支持时空组合能力与AI Agent灵活编排。
283 0
|
1月前
|
存储 人工智能 自然语言处理
阿里企业邮箱收费标准:标准版、AI尊享版和国产化版费用清单,2026年最新整理
阿里云企业邮箱提供免费版(0元)及三类付费版:标准版600元/年(适合初创企业)、AI尊享版720元/年(含AI写信、翻译、智能标签等)、国产化版900元/年(适配信创环境,满足政企合规要求)。
447 0
|
1月前
|
存储 人工智能 弹性计算
2026年10月,阿里云轻量应用服务器优惠活动,配置及参数(CPU、内存、存储空间)
2026年阿里云轻量应用服务器重磅升级:2核2G仅38元/年,全系标配200Mbps不限流量带宽+ESSD云盘,支持WordPress、AI智能体等一键部署。适合个人站长、AI爱好者及开发者测试,性价比拉满!
221 0
|
1月前
|
存储 Oracle 关系型数据库
双轨并行架构设计:全量迁移的并行策略、增量同步的延迟基准与双向Master实现
传统数据库迁移面临停机窗口长、数据一致性难保证、故障缺乏回退手段三大结构性挑战。双轨并行方案通过“全量迁移+增量同步+双向回切”的技术组合,将迁移从“一次性大爆炸”拆解为“可验证、可回退的渐进过程”。本文从全量迁移的并行策略、增量同步的日志解析与延迟控制、双向切换的决策点设计、一致性校验的触发机制四个层次展开。
|
1月前
|
人工智能 安全 IDE
阿里巴巴ATH事业群Qoder解决方案总监宁晓民:AI Native企业新范式——智能体重新定义生产力与生产关系 | 云栖分论坛演讲全文
在2026云栖大会,阿里Qoder总监宁晓民提出AI Native企业新范式:以“Harness”驾驭智能体,推动组织从“人指导agent”迈向“agent主动找人”;通过资产显性化、流程重构与可信治理,助力超级个体与超级组织协同进化。
405 0