Django中UserCreationForm的Password-based authentication区块解析及隐藏方法

1. 「Password-based authentication」区块是什么？ #

这是Django默认表单渲染机制生成的字段集（fieldset）标题，用来包裹注册表单中的密码相关字段（password1和password2），本质是HTML的<fieldset>标签及其<legend>标题，是Django为规范认证类表单布局自动添加的结构。

2. 它应该在此处显示吗？ #

完全取决于你的需求。Django默认添加这个字段集是为了表单布局的规范性，但对于注册页面来说，这个标题属于冗余内容——用户明确知道注册需要设置密码，所以绝大多数场景下不需要显示这个区块。

3. 如何隐藏这个区块？ #

有几种简单的实现方式：

方式一：手动渲染表单字段

放弃默认的{{ form }}渲染，在模板里逐个渲染字段，完全控制输出结构：

<h1>signup</h1>
<form method="post">
  {% csrf_token %}
  <div>
    {{ form.username.label_tag }}
    {{ form.username }}
    {% if form.username.errors %}
      <span class="error">{{ form.username.errors }}</span>
    {% endif %}
  </div>
  <div>
    {{ form.password1.label_tag }}
    {{ form.password1 }}
    {% if form.password1.errors %}
      <span class="error">{{ form.password1.errors }}</span>
    {% endif %}
  </div>
  <div>
    {{ form.password2.label_tag }}
    {{ form.password2 }}
    {% if form.password2.errors %}
      <span class="error">{{ form.password2.errors }}</span>
    {% endif %}
  </div>
  <button type="submit">注册</button>
</form>

方式二：使用as_p/as_table/as_ul渲染

Django提供了几种简化的表单渲染方法，这些方法不会生成字段集区块，直接用对应标签包裹字段：

<h1>signup</h1>
<form method="post">
  {% csrf_token %}
  {{ form.as_p }} {# 用<p>标签包裹每个字段 #}
  <button type="submit">注册</button>
</form>

也可以用{{ form.as_table }}（表格形式）或{{ form.as_ul }}（列表形式），按需选择。

方式三：修改表单类移除字段集

在RegisterForm的__init__方法中清除表单的字段集配置，让默认渲染不再生成fieldset：

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


class RegisterForm(UserCreationForm):
    """Form to Create new User"""

    class Meta:
        model = get_user_model()
        fields = ["username", "password1", "password2"]
    
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 移除字段集配置，避免生成Password-based authentication区块
        if hasattr(self, 'fieldsets'):
            self.fieldsets = None

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