Python 描述符（Descriptor）是一种实现属性访问拦截的代理类。通过实现 __get__、__set__、__delete__ 魔术方法，可以在读取、写入或删除属性时执行自定义逻辑，如参数校验、日志记录或动态计算。相比传统的 Getter/Setter，描述符能保持 API 的自然性并提高代码复用率。Python 内置的 @property、方法绑定及 ORM 框架均基于此机制。
在 Python 里，通常我们访问对象的属性（比如 obj.x），就像是从货架上直接拿东西，没有任何阻拦。
但是，如果你想在拿东西（读取）或放东西（写入）的时候搞点'小动作'——比如参数检查、日志记录、或者动态计算——你就需要一个'看门大爷'。
这个'看门大爷'，就是描述符 (Descriptor)。
在 Python 对象模型里，描述符就是一个把'属性访问'变成'方法调用'的代理类。
只要一个类实现了以下任意一个魔术方法，它生成的对象就是描述符：
__get__：有人要属性时触发（对应 ）。val = obj.x__set__：有人要改属性时触发（对应 obj.x = val）。__delete__：有人要删属性时触发（对应 del obj.x）。__set__）：柜员会检查钞票真伪（数据校验）。__get__）：柜员会核对你的身份，甚至计算利息给你（动态计算）。我们通过写一个**'强类型检查器'来演示。假设你需要定义一个学生类，要求分数必须是 0-100 的整数**。
这是'看门大爷'的自我修养。
class ScoreDescriptor:
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 is None:
return self
# 从 instance 的字典里把真值拿出来
return getattr(instance, self.internal_name, 0)
# 【写】当有人执行 student.math = 90 时
def __set__(self, instance, value):
print(f"👮 [SET] 正在批改 {self.subject_name}，分数为 {value}")
# --- 核心逻辑：拦截并检查 ---
if not isinstance(value, int):
raise TypeError(f"{self.subject_name} 分数必须是整数！")
if not (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)
注意：描述符必须定义在类属性（Class Attribute）层级。
class Student:
# 聘请两个'看门大爷'分别管理 数学 和 英语
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):
return f"Student(name={self.name}, math={self.math}, english={self.english})"
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 分数必须是整数！
你可能会问：'我在 Student 类里写个 get_math 和 set_math 不行吗？'
当然行，但描述符有两个巨大的优势：
s.math = 90 这种自然的语法，而不是 s.set_math(90)。这在 Python 这种动态语言里非常重要。ScoreDescriptor 类，然后实例化 10 次就行了。
这就好比：你不需要给每个房间都专门雇一个保安，你只需要雇一个保安公司（描述符类），然后给每个房间派个保安（实例）就行。即使你没写过 __get__，你也一直在用描述符：
@property：
这是一个内置的描述符，它是把一个函数伪装成属性的最简单方式。def foo(self): 定义在类里，通过实例 obj.foo() 调用时 self 就会自动传进去？
因为 函数 (Function) 本身就是一个实现了 __get__ 的描述符！每次访问 obj.foo，__get__ 都会动态生成一个'绑定方法 (Bound Method)'对象返回给你。name = models.CharField(max_length=100) —— 这里的 CharField 就是个巨大的描述符，它负责把 Python 对象的数据转换成 SQL 语句。__get__ = 拦截读取，控制返回什么值。__set__ = 拦截赋值，控制能否写入、写入什么。instance 参数 = 谁在调用我？（具体的对象实例）。owner 参数 = 谁拥有我？（类本身）。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online