Django模板表单错误提示显示label名替代字段名的方法

你之前的写法无法生效，核心原因是form.errors是字典结构，遍历得到的key是字符串类型的字段名（比如"name"），并非表单字段实例对象，因此无法直接访问.label属性。

推荐两种无兼容问题的写法，按需选择即可：

方案1：拆分全局错误和字段错误遍历（无需自定义标签） #

这种写法逻辑最清晰，不需要额外写模板过滤器，直接遍历表单字段实例即可拿到配置的label值：

{# 先处理不属于任何字段的全局错误（原__all__类型错误） #}
{% if form.non_field_errors %}
{% for error in form.non_field_errors %}
<div class="alert alert-danger alert-dismissible fade show" role="alert">
  <strong>Error:</strong> {{ error|striptags }}
</div>
{% endfor %}
{% endif %}

{# 再处理单个字段绑定的错误 #}
{% for field in form %}
{% if field.errors %}
{% for error in field.errors %}
<div class="alert alert-danger alert-dismissible fade show" role="alert">
  <strong>Error:</strong> 
  {% if field.label %}{{ field.label|title }} - {% endif %}
  {{ error|striptags }}
</div>
{% endfor %}
{% endif %}
{% endfor %}

该写法会自动兼容你在Meta.labels中配置的空标签场景：如果某个字段label设为空字符串，错误提示里就不会显示字段名前缀，完全匹配你的配置规则，同时支持多语言翻译的label值正常渲染。

方案2：保留原遍历逻辑，搭配简单自定义模板过滤器 #

如果你想保留原来遍历form.errors的代码结构，只需要加一个极短的自定义模板过滤器，实现动态根据字段名取label的能力：

1. 在对应app的templatetags目录下新建form_tags.py（确保目录下存在__init__.py文件），写入以下代码：

from django import template
register = template.Library()

@register.filter
def get_field_label(form, field_name):
    if field_name == "__all__":
        return ""
    return form.fields[field_name].label

2. 在模板顶部加载自定义标签：

{% load form_tags %}

3. 修改原循环代码为：

{% for field_name, error_list in form.errors.items %}
<div class="alert alert-danger alert-dismissible fade show" role="alert">
  <strong>Error:</strong> 
  {% with field_label=form|get_field_label:field_name %}
  {% if field_label %}{{ field_label|title }} - {% endif %}
  {% endwith %}
  {{ error_list|striptags }}
</div>
{% endfor %}

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