Python数据类中描述符的变量类型及运行原理解析

描述符是实例变量，不是类变量 #

直接给结论：你定义的LoginBody里，UserValidator是实例变量，而非类变量。因为数据类（dataclass）中把描述符设为字段默认值时，创建实例的过程会用传入的具体值覆盖这个默认的描述符对象，最终它只会存在于实例的属性字典里，不是类的属性字典。

输出'user'的具体机制 #

拿你的代码场景举例，假设LoginBody的定义类似这样：

from dataclasses import dataclass
from abc import ABC, abstractmethod

class Validator(ABC):
    @abstractmethod
    def __get__(self, instance, owner):
        pass

class UserValidator(Validator):
    def __get__(self, instance, owner):
        return instance._user
    def __set__(self, instance, value):
        if not isinstance(value, str):
            raise ValueError("用户必须是字符串类型")
        instance._user = value

@dataclass
class LoginBody:
    user: str = UserValidator()

当你执行b = LoginBody('user')时：

1. 数据类的初始化逻辑会把传入的'user'直接赋值给实例b的user属性，此时b.__dict__里会新增'user': 'user'这个键值对，完全覆盖了原本作为默认值的UserValidator实例。
2. 当你访问b.user时，Python的属性查找优先级是先查实例自身的__dict__，找到对应的字符串值后直接返回，根本不会去触发类层面的描述符逻辑——毕竟这个描述符从来没作为类变量存在过，早就被实例属性覆盖了。

这完全符合Python官方文档的规则：描述符只有作为类变量挂载在类上时，才会在属性查找/赋值时触发其__get__/__set__方法。如果是实例变量，Python会直接返回该属性的值，跳过描述符机制。

让描述符生效的正确写法 #

如果想让UserValidator的验证逻辑生效，需要把它定义为LoginBody的类变量，而非数据类字段的默认值。比如改成这样：

class LoginBody:
    user = UserValidator()
    def __init__(self, user):
        self.user = user  # 这里会触发UserValidator的__set__方法做验证

此时user是类变量（描述符），当你给实例赋值self.user时，会触发UserValidator的__set__方法做校验；访问b.user时，会触发__get__方法返回对应值。

内容的提问来源于stack exchange，提问作者Subham Kumar