Django实现表单对应字段内错误展示及自定义错误字段名

字段级错误直接在对应区域展示（含placeholder/输入框值展示方案） #

Django原生支持字段级错误绑定，不需要额外后端改造，直接在模板层控制渲染逻辑即可：

• 每个表单字段实例自带errors属性，存储当前字段的所有校验错误，按顺序取第一个错误文本就能拿到对应提示
• 要把错误放在输入框周边，直接在对应input标签相邻位置渲染{{ field.errors.0 }}即可
• 要把错误作为placeholder展示，直接把错误文本赋值给input的placeholder属性
• 要把错误直接作为输入框默认值展示，把错误文本赋值给input的value属性即可

参考模板代码：

{% for field in form %}
<div class="form-item">
    {% if field.errors %}
    <!-- 错误态：把错误文本塞到placeholder，输入框下方额外展示错误 -->
    <input 
        type="{{ field.field.widget.input_type }}"
        name="{{ field.name }}"
        placeholder="{{ field.errors.0 }}"
        class="input-error"
    >
    <span class="error-tip">{{ field.errors.0 }}</span>
    {% else %}
    <!-- 正常态：用默认placeholder渲染 -->
    {{ field }}
    {% endif %}
</div>
{% endfor %}

如果是手动编写单个输入框，直接取对应字段的错误即可，比如当前表单里的邮箱输入字段名为username，直接访问{{ form.username.errors.0 }}就能拿到对应字段的错误，不会和全局错误混淆。

自定义错误提示中的字段显示名称 #

错误提示显示username...error、模型层verbose_name配置不生效的核心原因：
AuthenticationForm是继承自普通forms.Form的认证表单，不是ModelForm，写的class Meta下的model、fields配置不会生效，表单不会自动拉取User模型里email字段的verbose_name配置。同时表单里重写的邮箱输入字段名硬编码为username，Django生成字段默认错误提示时会直接读取字段名作为占位文本。

两种可直接落地的解决方式：

1. 最稳妥：显式配置字段的error_messages
   直接给每个字段定义好所有场景下的错误文本，不需要Django自动拼接字段名，100%避免出现username字样。修改后的forms.py代码如下：

   class LoginForm(AuthenticationForm):   
       username = forms.EmailField(
           label="Email",
           required=True,
           error_messages={
               "required": "请输入Email地址",
               "invalid": "请输入有效的Email格式",
               "invalid_login": "Email或密码输入错误，请注意大小写区分"
           },
           widget=forms.TextInput(
               attrs={'placeholder': 'Email'}
       ))
       password = forms.CharField(
           label=False,
           max_length=50,
           required=True,
           error_messages={
               "required": "请输入登录密码"
           },
           widget=forms.PasswordInput(
               attrs={'placeholder': 'Senha'}
       ))
   

   这里可以删掉不生效的class Meta配置，因为继承的AuthenticationForm本身不识别ModelForm的Meta配置。

2. 全局修改字段显示名（适合不想逐条写错误提示的场景）
   在表单的__init__方法里显式修改字段的label属性，同时覆写AuthenticationForm自带的错误消息占位符，让Django自动拼接错误时用指定的字段名：

   class LoginForm(AuthenticationForm):
       # 保留原有字段定义即可
       def __init__(self, *args, **kwargs):
           super().__init__(*args, **kwargs)
           # 强制把username字段的显示名设为Email
           self.fields['username'].label = "Email"
           # 覆写默认登录错误消息的占位符
           self.error_messages['invalid_login'] = "请输入正确的%(username)s和密码，请注意大小写区分"
   

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