如何为Django UserCreationForm添加字段并修改/移除默认文本？

一、扩展User模型添加姓名、姓氏字段 #

直接基于AbstractUser扩展默认用户模型，这是Django官方推荐的方式：

• 在你的app目录下的models.py中添加：

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

class CustomUser(AbstractUser):
    first_name = models.CharField("名字", max_length=100)
    last_name = models.CharField("姓氏", max_length=100)
    # 按需添加其他字段，比如手机号、地址等

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

AUTH_USER_MODEL = '你的app名称.CustomUser'

• 执行数据库迁移生效：

python manage.py makemigrations
python manage.py migrate

二、自定义注册表单控制字段与文本 #

替换默认的注册表单，自定义字段标签、提示文本：

• 在app目录下创建forms.py，写入：

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

class CustomUserCreationForm(UserCreationForm):
    class Meta:
        model = CustomUser
        # 指定注册页面要显示的字段
        fields = ('username', 'first_name', 'last_name', 'email', 'password1', 'password2')
        # 自定义字段显示的标签文本
        labels = {
            'username': '用户名',
            'first_name': '名字',
            'last_name': '姓氏',
            'email': '邮箱',
            'password1': '密码',
            'password2': '确认密码',
        }
        # 自定义字段的帮助提示文本
        help_texts = {
            'username': '必填，150字符以内，仅支持字母、数字及@/./+/-/_',
            'password1': '密码不能与个人信息关联，至少8位，避免使用常见密码',
        }

三、配置视图与模板使用自定义表单 #

如果用自带视图或自定义视图，都要绑定这个表单：

自定义注册视图示例 #

在app的views.py中：

from django.contrib.auth import login
from django.shortcuts import render, redirect
from .forms import CustomUserCreationForm

def register(request):
    if request.method == 'POST':
        form = CustomUserCreationForm(request.POST)
        if form.is_valid():
            user = form.save()
            login(request, user)
            return redirect('home')  # 替换为你的首页路由名称
    else:
        form = CustomUserCreationForm()
    return render(request, 'registration/register.html', {'form': form})

模板渲染表单 #

在templates/registration/register.html中：

<form method="post">
    {% csrf_token %}
    {{ form.as_p }}
    <button type="submit">注册</button>
</form>

四、实现多语言文本切换（国际化） #

如果需要支持多种语言切换，按以下步骤配置：

1. 修改settings.py的国际化配置：

USE_I18N = True

# 支持的语言列表
LANGUAGES = [
    ('zh-hans', '简体中文'),
    ('en', 'English'),
]

# 翻译文件存放路径
LOCALE_PATHS = [
    BASE_DIR / 'locale',
]

2. 生成对应语言的翻译文件：

# 生成简体中文翻译文件
python manage.py makemessages -l zh_Hans

3. 编辑翻译文件：
   打开locale/zh_Hans/LC_MESSAGES/django.po，找到需要替换的英文文本，修改msgstr为对应中文，比如：

msgid "Password"
msgstr "密码"

msgid "Confirm password"
msgstr "确认密码"

msgid "Register"
msgstr "注册"

4. 编译翻译文件生效：

python manage.py compilemessages

5. 添加语言切换功能：
   在模板中加入切换表单，同时在urls.py中配置路由：

• 模板代码：

<form action="{% url 'set_language' %}" method="post">
    {% csrf_token %}
    <input name="next" type="hidden" value="{{ redirect_to }}">
    <select name="language">
        {% get_available_languages as LANGUAGES %}
        {% get_current_language as CURRENT_LANGUAGE %}
        {% for lang_code, lang_name in LANGUAGES %}
            <option value="{{ lang_code }}" {% if lang_code == CURRENT_LANGUAGE %}selected{% endif %}>
                {{ lang_name }}
            </option>
        {% endfor %}
    </select>
    <input type="submit" value="切换语言">
</form>

• 路由配置（在项目urls.py中）：

from django.conf.urls.i18n import set_language

urlpatterns = [
    # 其他路由
    path('set-language/', set_language, name='set_language'),
]

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