如何修改Django UserCreationForm的标签、错误信息等属性？

修改username的标签 #

有两种常用方式可以自定义username字段的显示标签：

方式1：重写字段并指定label #

直接在表单类中重新定义username字段，通过label参数设置自定义文本：

from django.contrib.auth.forms import UserCreationForm
from django.contrib.auth import get_user_model
from django import forms

User = get_user_model()

class SignupForm(UserCreationForm):
    # 替换成你需要的标签文本
    username = forms.CharField(label='账号名称')

    class Meta:
        model = User
        fields = ['username', 'email', 'password1', 'password2']

方式2：通过Meta类的labels属性配置 #

在表单的Meta类中添加labels字典，为username指定自定义标签：

from django.contrib.auth.forms import UserCreationForm
from django.contrib.auth import get_user_model

User = get_user_model()

class SignupForm(UserCreationForm):
    class Meta:
        model = User
        fields = ['username', 'email', 'password1', 'password2']
        labels = {
            'username': '账号名称',  # 自定义标签文本
        }

修改username的错误信息 #

根据不同的错误场景，有两种灵活的修改方式：

方式1：通过字段的error_messages参数设置 #

重定义username字段时，用error_messages参数覆盖默认错误提示：

from django.contrib.auth.forms import UserCreationForm
from django.contrib.auth import get_user_model
from django import forms

User = get_user_model()

class SignupForm(UserCreationForm):
    username = forms.CharField(
        label='账号名称',
        error_messages={
            'required': '请填写账号名称',
            'unique': '该账号已被注册',
            'min_length': '账号长度不能少于3个字符',
            'max_length': '账号长度不能超过150个字符',
        }
    )

    class Meta:
        model = User
        fields = ['username', 'email', 'password1', 'password2']

方式2：重写clean_username方法实现自定义验证 #

如果需要更复杂的验证逻辑或个性化错误提示，可以重写表单的clean_username方法：

from django.contrib.auth.forms import UserCreationForm
from django.contrib.auth import get_user_model
from django.core.exceptions import ValidationError

User = get_user_model()

class SignupForm(UserCreationForm):
    class Meta:
        model = User
        fields = ['username', 'email', 'password1', 'password2']

    def clean_username(self):
        username = self.cleaned_data.get('username')
        # 检查用户名是否已存在
        if User.objects.filter(username=username).exists():
            raise ValidationError('这个账号已经被使用了，请换一个')
        # 自定义长度校验
        if len(username) < 3:
            raise ValidationError('账号至少需要3个字符')
        # 返回校验后的用户名
        return username

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