Django源代码中定义的django.contrib.auth.User在哪里

Question

在Django official guide 中，内容如下：

在这个django.contrib.auth 模型中，有一个User 类，它具有以下属性（用户名、密码、电子邮件、名字、姓氏）。

在github查看源码时，在django.contrib.auth中没有找到这个定义。
我只能在django/contrib/auth/base_user.py on this link 中看到class AbstractBaseUser(models.Model):，在django/contrib/auth/models.py in this webpage 中看到class User(AbstractUser):。

Q1：上面官方文档中class models.User是什么意思，意思是User是models.py下的一个类？

Q2：如果上面是对的，那么User类在哪里获取用户名、电子邮件等属性？

Answer 1

Q1：上面官方文档中的models.User类是什么意思，也就是说User是models.py下的一个类？

在 Django 中，一个是指带有<i>app_name</i>.<i>ModelName</i> 的模型。所以如果你指定一个模型，这是在<i>app_name</i>/models.py 中实现的，但是由于模型是在models.py 文件中定义的，所以在模型名称中包含它是没有意义的。

例如AUTH_USER_MODEL setting [Django-doc] 的默认值是auth.User，因为应用程序的名称是auth，而模型的名称是User。

Q2：如果上面是对的，那么 User 类在哪里获取用户名、电子邮件等属性？

通过继承。事实上，如果我们查看source code of the models.py file [GitHub]，我们会看到：

class User(AbstractUser):
    """
    Users within the Django authentication system are represented by this
    model.
    Username and password are required. Other fields are optional.
    """
    class Meta(AbstractUser.Meta):
        swappable = 'AUTH_USER_MODEL'

而AbstractUser model [GitHub] 定义了username、email 等的字段：

class AbstractUser(AbstractBaseUser, PermissionsMixin):
    # …

    username = models.CharField(
        _('username'),
        max_length=150,
        unique=True,
        help_text=_('Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.'),
        validators=[username_validator],
        error_messages={
            'unique': _("A user with that username already exists."),
        },
    )
    first_name = models.CharField(_('first name'), max_length=150, blank=True)
    last_name = models.CharField(_('last name'), max_length=150, blank=True)
    email = models.EmailField(_('email address'), blank=True)
    is_staff = models.BooleanField(
        _('staff status'),
        default=False,
        help_text=_('Designates whether the user can log into this admin site.'),
    )
    is_active = models.BooleanField(
        _('active'),
        default=True,
        help_text=_(
            'Designates whether this user should be treated as active. '
            'Unselect this instead of deleting accounts.'
        ),
    )
    date_joined = models.DateTimeField(_('date joined'), default=timezone.now)
    
    # …

AbstractUser 是一个抽象模型。这意味着 Django 不会为它创建表。因此，从抽象表继承的模型将继承字段、方法等，然后这些字段将在从 AbstractUser 继承的模型上定义。