描述符类需实现__set__方法拦截赋值并做类型检查，必须定义为类属性；存储值应绑定到具体实例（如instance.__dict__），避免共享；支持none需显式判断，不可用真值判断；dataclass的field不执行运行时类型校验。
Descriptor 类怎么写才能拦截属性赋值
类型检查的核心是拦截 __set__，不是 __get__。只要没在 __set__ 里做校验，赋值就绕过检查了。描述符必须定义为类属性（不能在 __init__ 里实例化），否则 Python 不会触发描述符协议。
常见错误：把描述符实例放在实例属性里，比如 self.name = StringDescriptor() —— 这样完全不生效，因为描述符只对类属性起作用。
- 描述符类必须实现
__set__（至少）；__get__和__delete__可选 - 类中声明时直接赋值：
name = StringDescriptor()，不是self.name = ... - 如果需要存储值，别存在描述符实例自己身上（会跨实例共享），用
instance.__dict__或weakref绑定到具体对象
如何避免 type check 在 None 赋值时崩溃
很多描述符一遇到 None 就抛 TypeError，但业务里字段允许为空很常见。硬性要求非空，得显式声明，而不是默认拦截 None。
典型陷阱：写 if not value: 判断，结果 0、False、空字符串全被误判为非法。
- 检查类型用
isinstance(value, expected_type)，别用真值判断 - 允许
None时，先单独判断：if value is None: return - 若需支持可选类型（如
str | None），在描述符初始化时加nullable=True参数，并在__set__中分支处理
多个字段共用同一描述符类时怎么隔离状态
描述符实例是共享的，但每个字段要独立存值。如果直接在描述符里用 self._value = ...，所有使用该描述符的字段都会互相覆盖。
正确做法是把值存在托管实例上，靠 instance 参数区分归属。但要注意：不能无脑往 instance.__dict__ 写，可能和用户自定义属性名冲突（比如用户也叫 _name）。
- 推荐用带前缀的私有键：
key = f'_descriptor_{self.name}'，其中self.name在描述符初始化时传入 - 更健壮的做法是用
__set_name__钩子自动获取属性名：def __set_name__(self, owner, name): self.attr_name = name - 避免用
setattr(instance, ...)触发递归（如果被设属性恰好也是描述符），一律走instance.__dict__[key] = value
为什么 dataclass + field(type=...) 不等于 descriptor 类型检查
dataclass 的 field 只做注解保留和默认值管理，运行时不校验类型。哪怕写了 name: str，你照样能 obj.name = 123，不会报错。
真正生效的类型检查必须靠运行时拦截，也就是描述符或 __setattr__。第三方库如 pydantic 或 attrs 是封装好的方案，但底层仍是类似描述符的机制。
-
typing注解本身是静态的，仅对 IDE 和 mypy 有效，Python 解释器忽略它们 - 想让类型约束在运行时强制执行，必须主动介入属性访问路径——描述符是最轻量、最可控的方式
- 注意：描述符无法检查函数参数或返回值，那是装饰器或类型检查器的职责范围
描述符的难点不在写法，而在状态绑定策略和 None/空值边界。写一个能跑通的 __set__ 很容易，但让它在继承、多字段、可空场景下不翻车，得反复验证 instance 生命周期和属性名冲突点。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
