自定义用户模型 可以替代 Django 默认的 User，以满足应用程序的需求 — 添加字段、改变登录标识符（例如用电子邮件替代用户名），或自定义行为。关键的、反复强调的建议是：在项目的最初阶段 设置自定义用户模型，即使你现在不需要更改，因为稍后更改它会非常痛苦。
The default User has fixed fields (username, email, first/last name) and uses
USERNAME as the login field. Real apps often need:
✓ Email-based login (no username)
✓ Extra fields (phone, avatar, role, preferences) on the user itself
✓ Custom authentication behavior
⚠️ Changing the user model AFTER migrations exist is VERY hard — the User model is
referenced by auth, admin, sessions, foreign keys throughout the database.
Swapping it later requires complex, risky data migrations.
→ ALWAYS define a custom user model at project START (before the first migration),
even an empty one, so you can extend it freely later. Django's docs strongly
recommend this for EVERY new project.
这是关键的实践经验：在第一天设置自定义用户模型的成本几乎为零，但在已经建立的项目中改造一个是一项重大的、容易出错的工作 — 所以你提前做这件事作为保险。
# models.py — add fields, keep Django's auth behavior
from django.contrib.auth.models import AbstractUser
class User(AbstractUser):
phone = models.CharField(max_length=20, blank=True)
avatar = models.ImageField(upload_to="avatars/", blank=True)
is_premium = models.BooleanField(default=False)
# settings.py — tell Django to use it
AUTH_USER_MODEL = "myapp.User"
AbstractUser 保留了 Django 所有默认字段和身份验证机制 — 你只需添加字段。这是最简单、最常见的方法。
from django.contrib.auth.models import AbstractBaseUser, BaseUserManager, PermissionsMixin
class User(AbstractBaseUser, PermissionsMixin):
email = models.EmailField(unique=True)
USERNAME_FIELD = "email" # log in with EMAIL instead of username
REQUIRED_FIELDS = []
objects = CustomUserManager() # a manager defining create_user/create_superuser
AbstractBaseUser 对用户模型提供完全控制（例如完全删除用户名以实现仅电子邮件登录）— 需要更多工作，但获得最大灵活性。
from django.conf import settings
from django.contrib.auth import get_user_model
# in models — reference via settings.AUTH_USER_MODEL
author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
# in code — get the active user model dynamically
User = get_user_model() # NOT a direct import of the default User
始终通过 settings.AUTH_USER_MODEL（在模型中）和 get_user_model()（在代码中）引用用户模型，永远不要直接导入默认的 User — 这样你的代码就能与自定义模型兼容。
使用自定义用户模型是重要知识，包含一个关键的、经常强调的实践经验课程，每个 Django 开发者都应该理解：在每个项目的最初阶段设置它。
这件事之所以这么重要的原因是难度上的严重不对称 — 在第一天定义自定义用户模型（即使是空的 AbstractUser 子类）的成本几乎为零，并提供了宝贵的灵活性，而在项目已有迁移和数据之后切换到自定义用户模型则非常困难且危险，因为 User 模型在 Django 中被深度引用（身份验证、admin、会话）并通过整个数据库的外键引用，需要复杂的、容易出错的数据迁移来更改。
这就是为什么 Django 自身文档强烈建议每个新项目都使用自定义用户模型，无论是否有立即需求 — 它是对未来迁移噩梦的保险。
除了这个关键的时间建议之外，理解如何创建自定义用户模型 — AbstractUser 用于在保持 Django 身份验证行为的同时简单地添加字段（常见、简单的情况），以及 AbstractBaseUser 用于完全控制如基于电子邮件的登录（完全删除用户名）— 对于满足实际应用程序需求（额外的用户字段、替代登录标识符、自定义身份验证）是有价值的。
同样重要的是知道要正确引用用户模型（通过 settings.AUTH_USER_MODEL 和 get_user_model()，永远不是直接导入），所以代码能与任何配置的用户模型一起工作。
因为几乎每个真实的应用程序都有超越 Django 默认值的用户特定需求（即使那些没有的应用也能从灵活性中受益），并且因为不尽早设置这个的成本如此之高，理解自定义用户模型 — 特别是在项目开始时建立一个的必要性 — 是重要的、实践上关键的知识，能够防止一个常见且严重的项目级错误，使其成为经常引用的 Django 最佳实践智慧。