能否不通过一对一关联，直接扩展Django User模型字段？

核心结论 #

可以不用一对一关联模型实现需求，但直接修改Django内置User模型的源码是绝对不可取的——这会导致迁移失效、Django升级后代码丢失，且admin面板因默认配置未包含新增字段而无法显示。以下是两种合法实现方式：

方式一：自定义User模型（官方推荐） #

这是Django官方认可的扩展用户模型的标准方案，无关联开销，适配所有Django功能。

步骤1：创建自定义User模型 #

在你的app的models.py中继承AbstractUser并添加自定义字段：

from django.contrib.auth.models import AbstractUser
from django.db import models

class CustomUser(AbstractUser):
    # 布尔字段示例
    is_verified = models.BooleanField(default=False, verbose_name="是否已验证")
    # 选择字段示例
    user_type = models.CharField(
        max_length=20,
        choices=[('admin', '管理员'), ('regular', '普通用户')],
        default='regular',
        verbose_name="用户类型"
    )

步骤2：配置默认用户模型 #

在项目根目录的settings.py中指定自定义模型为默认用户模型：

AUTH_USER_MODEL = '你的app名.CustomUser'

步骤3：配置Admin面板显示自定义字段 #

在app的admin.py中自定义UserAdmin并注册：

from django.contrib import admin
from django.contrib.auth.admin import UserAdmin
from .models import CustomUser

class CustomUserAdmin(UserAdmin):
    # 列表页显示自定义字段
    list_display = ('username', 'email', 'is_verified', 'user_type', 'is_staff')
    # 编辑页添加自定义字段分组
    fieldsets = UserAdmin.fieldsets + (
        ('自定义信息', {'fields': ('is_verified', 'user_type')}),
    )

admin.site.register(CustomUser, CustomUserAdmin)

注意 #

• 此方案需在项目初始化时配置，若已存在迁移记录，需手动调整数据库（或重新初始化）。

方式二：动态扩展内置User模型（不推荐生产环境） #

若因历史原因无法替换默认User模型，可通过动态添加字段实现，但存在兼容风险。

步骤1：动态添加字段 #

在app的models.py中使用add_to_class方法添加字段：

from django.contrib.auth.models import User
from django.db import models

# 动态添加布尔字段
User.add_to_class('is_verified', models.BooleanField(default=False, verbose_name="是否已验证"))
# 动态添加选择字段
User.add_to_class('user_type', models.CharField(
    max_length=20,
    choices=[('admin', '管理员'), ('regular', '普通用户')],
    default='regular',
    verbose_name="用户类型"
))

步骤2：修改Admin面板配置 #

在app的admin.py中重载默认UserAdmin并重新注册：

from django.contrib import admin
from django.contrib.auth.admin import UserAdmin
from django.contrib.auth.models import User

class CustomizedUserAdmin(UserAdmin):
    list_display = UserAdmin.list_display + ('is_verified', 'user_type')
    fieldsets = UserAdmin.fieldsets + (
        ('自定义信息', {'fields': ('is_verified', 'user_type')}),
    )

# 先注销默认的UserAdmin，再注册自定义版本
admin.site.unregister(User)
admin.site.register(User, CustomizedUserAdmin)

缺点 #

• 无法自动生成迁移文件，需手动编写SQL添加字段；
• Django版本升级可能导致兼容性问题；
• 代码可读性差，不利于维护。

你之前遇到的问题原因 #

直接修改Django内置User模型的源码后：

1. Django的迁移系统不会识别这些修改，字段并未真正同步到数据库；
2. 默认的UserAdmin未配置显示新增字段，因此admin面板无法看到。

内容的提问来源于stack exchange，提问作者MicCheck-