不能直接继承AbstractUser，因Django要求自定义用户模型必须在首个迁移前定义且AUTH_USER_MODEL不可回退；已有迁移需清库重来或走复杂路径，新项目应先定义模型再配置，老项目宜用ProxyModel或导出重建。
为什么不能直接继承 AbstractUser 就完事？
很多人一上来就写 class CustomUser(AbstractUser)，跑起来发现 admin 后台进不去、createsuperuser 报错、登录态失效——核心原因是 Django 要求自定义用户模型必须在项目初始化阶段就确定，且一旦迁移过 auth_user 表，就无法再切换。
关键约束：必须在第一个迁移之前完成定义，且 AUTH_USER_MODEL 配置不可回退。如果你的项目已有迁移文件（尤其是 0001_initial.py 里含 auth.User 相关操作），就得清库重来或走复杂迁移路径。
- 新项目：立刻停手，先定义模型、改配置、再
makemigrations - 已有数据的老项目：不要硬切；考虑用
ProxyModel扩展字段，或导出→清库→重建→导入 -
AbstractUser适合加字段；AbstractBaseUser+PermissionsMixin才适合彻底换认证逻辑（比如用手机号登录）
AbstractBaseUser 和 AbstractUser 到底选哪个？
区别不在“功能多寡”，而在“控制粒度”。AbstractUser 包含了 username、first_name、last_name、email、权限字段和方法，但如果你打算弃用 username、改用邮箱唯一登录，它反而会拖后腿——因为它的 USERNAME_FIELD = 'username' 是写死的，且 email 字段默认非唯一。
真正需要替换登录凭证时，必须用 AbstractBaseUser，手动补全 is_active、is_staff、is_superuser、last_login 等字段，并显式混入 PermissionsMixin。
立即学习“Python免费学习笔记（深入）”；
- 要保留 username 登录 + 增加手机号字段 → 用
AbstractUser - 要邮箱/手机号作为唯一登录标识 → 必须用
AbstractBaseUser - 无论哪种，都得重写
create_user和create_superuser方法，否则manage.py createsuperuser会失败
admin 后台不显示新用户模型？三个漏掉就白干的配置
Django 不会自动把你的 CustomUser 注册到 admin，也不会自动适配用户创建表单。常见现象：后台用户列表还是空的，点“添加用户”弹出的是旧表单，甚至报 KeyError: 'password'。
强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能，主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该
必须同步做三件事：
- 在
admin.py中显式注册：admin.site.register(CustomUser, CustomUserAdmin) - 继承
UserAdmin并重写add_form和form属性，指向你自定义的表单类（否则密码不会被哈希） - 在自定义表单中，对密码字段必须用
ReadOnlyPasswordHashField（编辑页）和UserCreationForm子类（新建页），否则密码明文存储
示例关键片段：
class CustomUserCreationForm(UserCreationForm):
class Meta(UserCreationForm.Meta):
model = CustomUser
fields = ('email', 'name')
class CustomUserAdmin(UserAdmin):
add_form = CustomUserCreationForm
form = CustomUserChangeForm
model = CustomUser
list_display = ('email', 'name', 'is_staff', 'is_active')
list_filter = ('is_staff', 'is_active')
fieldsets = (
(None, {'fields': ('email', 'password', 'name')}),
('Permissions', {'fields': ('is_staff', 'is_active')}),
)
add_fieldsets = (
(None, {
'classes': ('wide',),
'fields': ('email', 'name', 'password1', 'password2', 'is_staff', 'is_active')}
),
)
search_fields = ('email',)
ordering = ('email',)
AUTH_USER_MODEL 配置写错的典型错误
这个字符串不是随便写的路径，格式必须是 '<app_label>.<model_name>'</model_name></app_label>，且 <app_label></app_label> 是 INSTALLED_APPS 里注册的应用名，不是包路径或文件夹名。
常见翻车点：
- 写成
'myapp.models.CustomUser'→ 错！多了.models - 写成
'users.CustomUser'但INSTALLED_APPS里写的是'apps.users'→ 错！必须完全一致 - 模型定义在
models.py以外（比如拆到models/user.py），但没在models/__init__.py中导出 →makemigrations会找不到模型 - 改完
AUTH_USER_MODEL没删掉已有的迁移文件（特别是auth相关的），导致migrate报InconsistentMigrationHistory
最稳妥做法：改配置 → 删除所有迁移文件（除 __init__.py）→ python manage.py makemigrations → python manage.py migrate。
字段命名、迁移顺序、admin 表单耦合度高，任一环节松动都会让整个用户系统卡住。别信“只改一个地方就行”的说法。
