如何在Django中创建含额外字段的用户？无法使用UserCreationForm

如果需要给用户添加更多字段，有两种主流方案，可根据项目阶段选择：

方案一：扩展AbstractUser（推荐新项目使用） #

直接继承Django内置的AbstractUser，在其基础上添加自定义字段，替换默认的用户模型。

步骤1：定义自定义用户模型 #

在你的app的models.py中：

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

class CustomUser(AbstractUser):
    # 添加你需要的额外字段，示例如下
    phone_number = models.CharField(max_length=15, blank=True, verbose_name="手机号")
    address = models.TextField(blank=True, verbose_name="地址")
    date_of_birth = models.DateField(null=True, blank=True, verbose_name="出生日期")

    # 可选：重写create_user方法，统一处理字段逻辑
    def create_user(self, username, email=None, password=None, **extra_fields):
        # 调用父类方法创建基础用户
        user = super().create_user(username, email, password, **extra_fields)
        # 可在这里添加额外字段的默认值或验证逻辑
        return user

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

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

AUTH_USER_MODEL = "your_app_name.CustomUser"

注意：这一步必须在第一次迁移前完成，否则后续修改会很麻烦。

步骤3：迁移数据库 #

执行以下命令，让Django生成并应用模型迁移：

python manage.py makemigrations
python manage.py migrate

步骤4：自定义注册表单 #

由于默认的UserCreationForm适配原用户模型，需要自定义表单处理新字段：

from django.contrib.auth.forms import UserCreationForm
from .models import CustomUser

class CustomUserCreationForm(UserCreationForm):
    class Meta:
        model = CustomUser
        # 指定需要在表单中显示的字段，包含默认字段和自定义字段
        fields = ("username", "email", "phone_number", "address", "password1", "password2")

步骤5：在视图中使用表单 #

示例注册视图：

from django.shortcuts import render, redirect
from .forms import CustomUserCreationForm

def user_register(request):
    if request.method == "POST":
        form = CustomUserCreationForm(request.POST)
        if form.is_valid():
            form.save()
            # 注册完成后跳转到登录页或首页
            return redirect("login")
    else:
        form = CustomUserCreationForm()
    return render(request, "register.html", {"form": form})

方案二：用OneToOneField关联扩展模型（适合已有项目） #

如果不想替换默认的User模型，可以创建一个关联模型，存储额外字段。

步骤1：定义关联模型 #

在app的models.py中：

from django.contrib.auth.models import User
from django.db import models
from django.db.models.signals import post_save
from django.dispatch import receiver

class UserProfile(models.Model):
    # 与默认User模型一对一关联
    user = models.OneToOneField(User, on_delete=models.CASCADE, related_name="profile")
    phone_number = models.CharField(max_length=15, blank=True)
    address = models.TextField(blank=True)
    date_of_birth = models.DateField(null=True, blank=True)

# 添加信号，创建User时自动生成对应的Profile
@receiver(post_save, sender=User)
def create_user_profile(sender, instance, created, **kwargs):
    if created:
        UserProfile.objects.create(user=instance)

@receiver(post_save, sender=User)
def save_user_profile(sender, instance, **kwargs):
    instance.profile.save()

步骤2：迁移数据库 #

同样执行迁移命令：

python manage.py makemigrations
python manage.py migrate

步骤3：创建用户并设置额外字段 #

创建用户时，直接关联更新Profile字段：

# 创建基础用户
user = User.objects.create_user(username="test_user", email="test@example.com", password="123456")
# 更新额外字段
user.profile.phone_number = "13800138000"
user.profile.address = "北京市朝阳区"
user.profile.save()

步骤4：自定义表单（可选） #

如果需要在注册时同时填写基础字段和额外字段，可以自定义一个表单，合并处理User和Profile：

from django import forms
from django.contrib.auth.models import User
from .models import UserProfile

class UserRegisterForm(forms.ModelForm):
    password = forms.CharField(widget=forms.PasswordInput)
    password2 = forms.CharField(widget=forms.PasswordInput, label="确认密码")

    class Meta:
        model = User
        fields = ("username", "email")

    # 自定义表单字段，对应Profile的字段
    phone_number = forms.CharField(max_length=15, required=False)
    address = forms.CharField(widget=forms.Textarea, required=False)

    def clean_password2(self):
        # 验证两次密码是否一致
        password = self.cleaned_data.get("password")
        password2 = self.cleaned_data.get("password2")
        if password and password2 and password != password2:
            raise forms.ValidationError("两次输入的密码不一致")
        return password2

    def save(self, commit=True):
        # 保存User和Profile
        user = super().save(commit=False)
        user.set_password(self.cleaned_data["password"])
        if commit:
            user.save()
            # 创建或更新Profile
            profile, created = UserProfile.objects.get_or_create(user=user)
            profile.phone_number = self.cleaned_data["phone_number"]
            profile.address = self.cleaned_data["address"]
            profile.save()
        return user

内容的提问来源于stack exchange，提问作者Anshul Gupta