Python 中的 __set__ 与 __set_name__ 深度解析
这两个方法都属于描述符协议（Descriptor Protocol），是 Python 元编程的核心机制之一。
一、描述符协议基础
描述符是实现了以下至少一个方法的类：
| 方法 | 触发时机 | 类型 |
|---|---|---|
__get__ | 读取属性 | 非数据描述符（若单独使用） |
__set__ | 设置属性 | 数据描述符（含此方法） |
__delete__ | 删除属性 | 数据描述符（含此方法） |
__set_name__ | 类定义时 | 辅助方法（Python 3.6+） |
二、__set__详解
签名
def__set__(self,obj,value):...self：描述符实例本身obj：拥有该描述符的类的实例value：被赋予的值
核心机制
classDescriptor:def__get__(self,obj,objtype=None):print(f"__get__ called, obj={obj}")returnobj.__dict__.get('_value')def__set__(self,obj,value):print(f"__set__ called, value={value}")obj.__dict__['_value']=value# 注意：不能用 obj.attr = value，会无限递归！classMyClass:attr=Descriptor()m=MyClass()m.attr=42# 触发 __set__print(m.attr)# 触发 __get__输出：
__set__ called, value=42 __get__ called, obj=<__main__.MyClass object> 42⚠️ 数据描述符 vs 非数据描述符
属性查找优先级（MRO 之后）：
数据描述符 > 实例 __dict__ > 非数据描述符classNonData:"""只有 __get__，非数据描述符"""def__get__(self,obj,objtype=None):return"from descriptor"classData:"""有 __set__，数据描述符"""def__get__(self,obj,objtype=None):return"from descriptor"def__set__(self,obj,value):passclassA:x=NonData()y=Data()a=A()a.__dict__['x']="from instance"a.__dict__['y']="from instance"print(a.x)# "from instance" ← 实例 __dict__ 胜出print(a.y)# "from descriptor" ← 数据描述符胜出！实战：类型验证描述符
classTypedField:def__init__(self,expected_type):self.expected_type=expected_type self.storage_name=None# 后面由 __set_name__ 填充def__set__(self,obj,value):ifnotisinstance(value,self.expected_type):raiseTypeError(f"'{self.storage_name}' 期望{self.expected_type.__name__}，"f"得到{type(value).__name__}")obj.__dict__[self.storage_name]=valuedef__get__(self,obj,objtype=None):ifobjisNone:returnselfreturnobj.__dict__.get(self.storage_name)classPerson:name=TypedField(str)age=TypedField(int)p=Person()p.name="Alice"# ✅p.age=30# ✅p.age="thirty"# ❌ TypeError三、__set_name__详解（Python 3.6+）
为什么需要它？
在__set_name__出现之前，描述符不知道自己在宿主类中叫什么名字，只能手动传入：
# 旧方式（繁琐且容易出错）classPerson:name=TypedField(str,'name')# 必须手动重复写名字age=TypedField(int,'age')签名
def__set_name__(self,owner,name):...self：描述符实例owner：拥有该描述符的类（不是实例！）name：该描述符在类中的属性名
触发时机
__set_name__在类定义完成时由元类type.__new__自动调用，早于任何实例的创建。
classDescriptor:def__set_name__(self,owner,name):print(f"__set_name__ 被调用: owner={owner.__name__}, name='{name}'")self.name=nameclassMyClass:foo=Descriptor()# 类定义时立即触发bar=Descriptor()# 输出：# __set_name__ 被调用: owner=MyClass, name='foo'# __set_name__ 被调用: owner=MyClass, name='bar'与__set__联动：完整的描述符
classValidated:"""通用验证描述符，自动感知自身名称"""def__set_name__(self,owner,name):self.public_name=name# 外部访问名，如 'age'self.private_name='_'+name# 内部存储名，如 '_age'def__get__(self,obj,objtype=None):ifobjisNone:returnselfreturngetattr(obj,self.private_name,None)def__set__(self,obj,value):value=self.validate(value)setattr(obj,self.private_name,value)defvalidate(self,value):raiseNotImplementedErrorclassPositiveInt(Validated):defvalidate(self,value):ifnotisinstance(value,int)orvalue<=0:raiseValueError(f"必须是正整数，得到:{value!r}")returnvalueclassNonEmptyStr(Validated):defvalidate(self,value):ifnotisinstance(value,str)ornotvalue.strip():raiseValueError(f"不能为空字符串，得到:{value!r}")returnvalueclassProduct:name=NonEmptyStr()price=PositiveInt()stock=PositiveInt()p=Product()p.name="Python Book"p.price=99p.stock=10print(p.name,p.price,p.stock)# Python Book 99 10print(p.__dict__)# {'_name': 'Python Book', '_price': 99, '_stock': 10}四、__set_name__的高级用法
1. 感知宿主类（owner）
classLoggedField:def__set_name__(self,owner,name):self.name=name# 在宿主类上注册所有被追踪的字段ifnothasattr(owner,'_tracked_fields'):owner._tracked_fields=[]owner._tracked_fields.append(name)def__set__(self,obj,value):print(f"[LOG]{type(obj).__name__}.{self.name}={value!r}")obj.__dict__[self.name]=valuedef__get__(self,obj,objtype=None):ifobjisNone:returnselfreturnobj.__dict__.get(self.name)classConfig:host=LoggedField()port=LoggedField()timeout=LoggedField()print(Config._tracked_fields)# ['host', 'port', 'timeout']c=Config()c.host="localhost"# [LOG] Config.host = 'localhost'c.port=8080# [LOG] Config.port = 80802. 动态添加描述符（手动调用__set_name__）
如果在类定义之后动态添加描述符，需要手动调用__set_name__：
classMyDesc:def__set_name__(self,owner,name):self.name=namedef__set__(self,obj,value):obj.__dict__[self.name]=value*2def__get__(self,obj,objtype=None):returnobj.__dict__.get(self.name)ifobjelseself# 动态挂载desc=MyDesc()MyClass.new_attr=desc desc.__set_name__(MyClass,'new_attr')# ⬅ 必须手动调用！m=MyClass()m.new_attr=10print(m.new_attr)# 20五、与property的对比
property本身就是一个描述符，但描述符更灵活，可以复用：
# property：每个类属性都要写一次classCircle:@propertydefradius(self):returnself._radius@radius.setterdefradius(self,v):ifv<0:raiseValueError self._radius=v# 描述符：一次定义，到处复用classPositiveNumber:def__set_name__(self,owner,name):self.name=namedef__set__(self,obj,value):ifvalue<0:raiseValueError(f"{self.name}不能为负")obj.__dict__[self.name]=valuedef__get__(self,obj,objtype=None):returnobj.__dict__.get(self.name)ifobjelseselfclassCircle:radius=PositiveNumber()classRectangle:width=PositiveNumber()height=PositiveNumber()六、总结
__set__(self, obj, value) └─ 在实例赋值时触发（obj.attr = value） └─ 使描述符成为"数据描述符"，优先级高于实例 __dict__ └─ 存储值时用 obj.__dict__ 或 setattr(obj, private_name, value) __set_name__(self, owner, name) └─ 在类定义完成时由元类自动调用（一次性） └─ 提供描述符在类中的名称，解决自我引用问题 └─ 也可感知宿主类，用于注册、元数据收集等 └─ 动态挂载时需手动调用两者配合使用是构建可复用、类型安全的属性系统的标准模式，也是dataclasses、SQLAlchemy、Django ORM等框架底层的核心机制。