Python 里的“看门大爷”：彻底搞懂描述符 (Descriptors)

在 Python 里，通常我们访问对象的属性（比如obj.x），就像是从货架上直接拿东西，没有任何阻拦。

但是，如果你想在拿东西（读取）或放东西（写入）的时候搞点“小动作”——比如参数检查、日志记录、或者动态计算——你就需要一个“看门大爷”。

这个“看门大爷”，就是描述符 (Descriptor)。

一、 核心概念：什么是描述符？

在 Python 对象模型里，描述符就是一个把“属性访问”变成“方法调用”的代理类。

只要一个类实现了以下任意一个魔术方法，它生成的对象就是描述符：

1. __get__：有人要读属性时触发（对应val = obj.x）。
2. __set__：有人要改属性时触发（对应obj.x = val）。
3. __delete__：有人要删属性时触发（对应del obj.x）。

形象比喻

• 普通属性：像公共储物柜。你也拿，我也拿，谁都能塞进去任何东西（甚至塞个垃圾数据）。
• 描述符：像银行柜台。
• 你想存钱？（__set__）：柜员会检查钞票真伪（数据校验）。
• 你想取钱？（__get__）：柜员会核对你的身份，甚至计算利息给你（动态计算）。

二、 三大金刚详解（怎么用？）

我们通过写一个**“强类型检查器”来演示。假设你需要定义一个学生类，要求分数必须是 0-100 的整数**。

1. 定义描述符类（制定规则）

这是“看门大爷”的自我修养。

classScoreDescriptor:def__init__(self,subject_name):self.subject_name=subject_name# 我们用一个私有变量名来存真正的数据，防止死循环self.internal_name="_"+subject_name# 【读】当有人访问 student.math 时def__get__(self,instance,owner):# instance: 就是那个 student 对象 (如果是 Student.math 访问，这里是 None)# owner: 就是 Student 类本身print(f"🕵️ [GET] 正在查看{self.subject_name}成绩...")ifinstanceisNone:returnself# 从 instance 的字典里把真值拿出来returngetattr(instance,self.internal_name,0)# 【写】当有人执行 student.math = 90 时def__set__(self,instance,value):print(f"👮 [SET] 正在批改{self.subject_name}，分数为{value}")# --- 核心逻辑：拦截并检查 ---ifnotisinstance(value,int):raiseTypeError(f"{self.subject_name}分数必须是整数！")ifnot(0<=value<=100):raiseValueError(f"{self.subject_name}分数必须在 0-100 之间！")# 检查通过，存入 instance 的字典setattr(instance,self.internal_name,value)# 【删】当有人执行 del student.math 时def__delete__(self,instance):print(f"🗑️ [DEL] 删除{self.subject_name}成绩")delattr(instance,self.internal_name)

2. 使用描述符（聘请看门大爷）

注意：描述符必须定义在类属性（Class Attribute）层级。

classStudent:# 聘请两个“看门大爷”分别管理 数学 和 英语math=ScoreDescriptor("math")english=ScoreDescriptor("english")def__init__(self,name,math_score,english_score):self.name=name# 这里看似是普通赋值，实际上触发了 math.__set__()self.math=math_score self.english=english_scoredef__repr__(self):returnf"Student(name={self.name}, math={self.math}, english={self.english})"

3. 运行效果（见证奇迹）

s1=Student("小明",85,92)# 输出:# 👮 [SET] 正在批改 math，分数为 85# 👮 [SET] 正在批改 english，分数为 92# --- 测试读取 ---print(s1.math)# 输出:# 🕵️ [GET] 正在查看 math 成绩...# 85# --- 测试非法赋值 ---try:s1.math=120# 超过 100 分exceptValueErrorase:print(f"\n❌ 报错啦:{e}")# 输出: ❌ 报错啦: math 分数必须在 0-100 之间！try:s1.english="A+"# 类型错误exceptTypeErrorase:print(f"❌ 报错啦:{e}")# 输出: ❌ 报错啦: english 分数必须是整数！

三、 为什么要用描述符？（C++ 视角）

你可能会问：“我在Student类里写个get_math和set_math不行吗？”

当然行，但描述符有两个巨大的优势：

1. 保持 API 优雅：
   使用者依然可以用s.math = 90这种自然的语法，而不是s.set_math(90)。这在 Python 这种动态语言里非常重要。
2. 代码复用（DRY 原则）：
   如果你有 10 个学科（Math, English, Physics…），用传统 Getter/Setter 你要写 10 遍检查逻辑（if value < 0…）。
   用描述符，你写一次ScoreDescriptor类，然后实例化 10 次就行了。
   这就好比：你不需要给每个房间都专门雇一个保安，你只需要雇一个保安公司（描述符类），然后给每个房间派个保安（实例）就行。

四、 你其实天天在用它

即使你没写过__get__，你也一直在用描述符：

1. @property：
   这是一个内置的描述符，它是把一个函数伪装成属性的最简单方式。
2. 方法 (Methods)：
   为什么def foo(self):定义在类里，通过实例obj.foo()调用时self就会自动传进去？
   因为函数(Function)本身就是一个实现了__get__的描述符！每次访问obj.foo，__get__都会动态生成一个“绑定方法(Bound Method)”对象返回给你。
3. Django / SQLAlchemy：
   name = models.CharField(max_length=100)—— 这里的CharField就是个巨大的描述符，它负责把 Python 对象的数据转换成 SQL 语句。

五、 总结

• 描述符=属性访问拦截器。
• __get__= 拦截读取，控制返回什么值。
• __set__= 拦截赋值，控制能否写入、写入什么。
• instance参数= 谁在调用我？（具体的对象实例）。
• owner参数= 谁拥有我？（类本身）。