如何在Python的Django中自定义用户模型替换默认User表？-Python教程-PHP中文网

不能直接继承AbstractUser，因Django要求自定义用户模型必须在首个迁移前定义且AUTH_USER_MODEL不可回退；已有迁移需清库重来或走复杂路径，新项目应先定义模型再配置，老项目宜用ProxyModel或导出重建。

如何在python的django中自定义用户模型替换默认user表？

为什么不能直接继承 `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。

要保留 username 登录 + 增加手机号字段 → 用 AbstractUser
要邮箱/手机号作为唯一登录标识 → 必须用 AbstractBaseUser
无论哪种，都得重写 create_user 和 create_superuser 方法，否则 manage.py createsuperuser 会失败

admin 后台不显示新用户模型？三个漏掉就白干的配置

Django 不会自动把你的 CustomUser 注册到 admin，也不会自动适配用户创建表单。常见现象：后台用户列表还是空的，点“添加用户”弹出的是旧表单，甚至报 KeyError: 'password'。

必须同步做三件事：

Django Wrap

强戈环形山: 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` 配置写错的典型错误

这个字符串不是随便写的路径，格式必须是 '.'，且是 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