Django表单错误展示优化：如何用verbose_name替换字段名？

方法1：模板遍历错误时直接调用字段的verbose_name #

遍历表单错误时，不要直接用字段名，而是通过表单字段的label属性（默认对应Model里的verbose_name）来显示友好名称。模板代码示例：

{% if form.errors %}
  <div class="error-messages">
    {% for field_name, errors in form.errors.items %}
      <p>* {{ form.fields[field_name].label }}: {{ errors.0 }}</p>
    {% endfor %}
  </div>
{% endif %}

这里form.fields[field_name].label会自动读取Model中定义的verbose_name，比如Model里写name = models.CharField(verbose_name="用户名", max_length=20)，这里就会显示“用户名”。

方法2：给表单字段自定义错误信息时用%(label)s占位符 #

如果需要给特定字段设置自定义错误提示，在表单类里定义error_messages时，用%(label)s占位符，会自动替换成该字段的verbose_name：

from django import forms
from .models import YourModel

class YourForm(forms.ModelForm):
    class Meta:
        model = YourModel
        fields = "__all__"
    
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 给单个字段设置带占位符的错误信息
        self.fields['name'].error_messages = {
            'required': '%(label)s不能为空',
            'max_length': '%(label)s不能超过20个字符'
        }

这样验证不通过时，错误信息会自动显示“用户名不能为空”这类内容。

方法3：全局修改表单错误信息格式（可选） #

如果想统一所有表单的错误提示格式，可以重写ModelForm的__init__方法，批量给所有字段设置带%(label)s的错误信息：

class BaseModelForm(forms.ModelForm):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        for field in self.fields.values():
            # 覆盖默认的required错误信息
            field.error_messages.setdefault('required', f'{field.label}不能为空')

之后你的业务表单继承这个BaseModelForm即可。

注意：如果表单字段手动设置了label属性，会优先使用这个值，而不是Model的verbose_name，所以保持默认不手动改label就能直接用Model里的配置。

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