Python类属性赋值无法通过__setattr__拦截，因其仅作用于实例属性；需将需校验的属性设为实例属性，并在__setattr__中依据预定义类型映射表（如_type_hints）用isinstance检查，失败则抛TypeError。
Python类属性赋值时如何触发类型检查
Python本身不拦截属性赋值，__setattr__ 是唯一能统一捕获所有实例属性写入的入口。但要注意：它不会拦截类属性（即定义在 class body 里的变量），只对 obj.attr = value 这类实例属性生效。如果你的目标是「给某个类的特定属性强制校验类型」，必须把该属性设计为实例属性，并在 __setattr__ 中做判断。
用 __setattr__ 实现字段级类型校验
核心思路是：在 __setattr__ 里查一个预定义的类型映射表，匹配当前属性名，再用 isinstance(value, expected_type) 判断。失败则直接抛 TypeError。
常见错误是把类型注解（age: int）当成运行时可读信息——默认情况下，它们只存在于 __annotations__，且不会自动参与赋值检查。你得手动提取并绑定到实例或类上。
- 推荐显式声明校验规则，例如用类变量
_type_hints = {"name": str, "age": int} - 避免依赖
getattr(self.__class__, "__annotations__", {})，因为继承链中注解可能被覆盖或丢失 - 注意不要在
__setattr__里调用super().__setattr__之前访问self.xxx，否则可能触发递归调用
class Person:
_type_hints = {"name": str, "age": int}
def __setattr__(self, name, value):
if name in self._type_hints:
expected = self._type_hints[name]
if not isinstance(value, expected):
raise TypeError(f"{name} must be {expected.__name__}, got {type(value).__name__}")
super().__setattr__(name, value)
为什么不用 @property + @xxx.setter
单独为每个字段写 @property 确实能精准控制，但会显著增加样板代码量，且无法动态增减字段。一旦字段名来自配置或数据库 schema，就难以维护。而 __setattr__ 方案天然支持字段名驱动的通用校验逻辑。
立即学习“Python免费学习笔记（深入）”；
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
性能上差异微小：现代 CPython 对 __setattr__ 的调用开销很低；但如果校验逻辑复杂（如嵌套结构验证），建议缓存类型映射字典，避免每次重复构建。
-
@property适合字段行为差异大（比如 age 要范围检查、email 要格式校验） -
__setattr__更适合“多数字段只做基础类型约束”的场景 - 二者可以混用：用
__setattr__做兜底，个别字段用@property覆盖特殊逻辑
类属性本身无法被拦截，别试图“强类型化 classvar”
像 class MyClass: VERSION: str = "1.0" 这样的类属性，Python 在类定义时就完成了赋值，__setattr__ 完全不介入。静态类型检查器（如 mypy）能报错，但运行时无感知。
如果你真需要运行时拦截类属性修改，只能重写类的 __setattr__（注意不是实例的），但这属于元编程范畴，会污染所有子类，且和常规使用习惯严重冲突。不推荐。
真正需要强约束的“常量类属性”，应改用 typing.Final 配合 mypy；运行时保护请用模块级常量或 enum.Enum。
