Python 里的“看门大爷”：彻底搞懂描述符 (Descriptors)
在 Python 里，通常我们访问对象的属性（比如 obj.x），就像是从货架上直接拿东西，没有任何阻拦。
但是，如果你想在拿东西（读取）或放东西（写入）的时候搞点“小动作”——比如参数检查、日志记录、或者动态计算——你就需要一个“看门大爷”。
这个“看门大爷”，就是描述符 (Descriptor)。
一、 核心概念：什么是描述符？
在 Python 对象模型里，描述符就是一个把“属性访问”变成“方法调用”的代理类。
只要一个类实现了以下任意一个魔术方法，它生成的对象就是描述符：
__get__：有人要读属性时触发（对应val = obj.x）。__set__：有人要改属性时触发（对应obj.x = val）。__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} 成绩...")if instance isNone:return self # 从 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):raise TypeError(f"{self.subject_name} 分数必须是整数！")ifnot(0<= value <=100):raise ValueError(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_score def__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 分except ValueError as e:print(f"\n❌ 报错啦: {e}")# 输出: ❌ 报错啦: math 分数必须在 0-100 之间！try: s1.english ="A+"# 类型错误except TypeError as e:print(f"❌ 报错啦: {e}")# 输出: ❌ 报错啦: english 分数必须是整数！三、 为什么要用描述符？（C++ 视角）
你可能会问：“我在 Student 类里写个 get_math 和 set_math 不行吗？”
当然行，但描述符有两个巨大的优势：
- 保持 API 优雅：
使用者依然可以用s.math = 90这种自然的语法，而不是s.set_math(90)。这在 Python 这种动态语言里非常重要。 - 代码复用（DRY 原则）：
如果你有 10 个学科（Math, English, Physics…），用传统 Getter/Setter 你要写 10 遍检查逻辑（if value < 0…）。
用描述符，你写一次ScoreDescriptor类，然后实例化 10 次就行了。
这就好比：你不需要给每个房间都专门雇一个保安，你只需要雇一个保安公司（描述符类），然后给每个房间派个保安（实例）就行。
四、 你其实天天在用它
即使你没写过 __get__，你也一直在用描述符：
@property：
这是一个内置的描述符，它是把一个函数伪装成属性的最简单方式。- 方法 (Methods)：
为什么def foo(self):定义在类里，通过实例obj.foo()调用时self就会自动传进去？
因为 函数(Function) 本身就是一个实现了__get__的描述符！每次访问obj.foo，__get__都会动态生成一个“绑定方法(Bound Method)”对象返回给你。 - Django / SQLAlchemy：
name = models.CharField(max_length=100)—— 这里的CharField就是个巨大的描述符，它负责把 Python 对象的数据转换成 SQL 语句。
五、 总结
- 描述符 = 属性访问拦截器。
__get__= 拦截读取，控制返回什么值。__set__= 拦截赋值，控制能否写入、写入什么。instance参数 = 谁在调用我？（具体的对象实例）。owner参数 = 谁拥有我？（类本身）。
