《Python 描述符魔法实战：用 Typed 守护你的属性类型》

《Python 描述符魔法实战：用 Typed 守护你的属性类型》

一、引言：属性背后的“魔法师”

在 Python 的世界里，属性访问并不总是简单的值读取或赋值。你是否想过：

• Django 的 ORM 字段为何能自动校验类型、生成 SQL？
• Vue.js 的计算属性为何能自动响应变化？
• Pydantic 如何实现字段验证与类型提示？

它们背后都有一个共同的魔法：描述符（Descriptor）。

描述符是一种将属性访问逻辑封装为类的机制，它让我们可以优雅地控制属性的 get、set、delete 行为。本文将带你深入理解描述符的原理，并手写一个类型检查器 Typed，帮助你在项目中实现强类型约束。

---

二、背景介绍：Python 的属性访问协议

Python 中的属性访问遵循以下协议：

• 如果一个类的属性实现了 __get__、__set__ 或 __delete__ 方法，那么它就是一个描述符。
• 当访问该属性时，Python 会自动调用这些方法，而不是直接操作值。

描述符协议：