Django表单字段标签在模板中不显示，求排查修正方案

问题描述 #

在Django项目中，自定义的ReviewForm表单字段标签无法在single-project.html模板中显示，以下是相关代码及修复方案。

相关代码 #

Review模型代码 #

class Review(models.Model):
    VOTE_TYPE = (
        ('up', 'Up Vote'),
        ('down', 'Down Vote')
    )
    owner = models.ForeignKey(Profile, on_delete=models.CASCADE, null=True)
    project = models.ForeignKey(Project, on_delete=models.CASCADE)
    body = models.TextField(null=True, blank=True)
    value = models.CharField(max_length=200, choices=VOTE_TYPE)
    created = models.DateTimeField(auto_now_add=True)
    id = models.UUIDField(default=uuid.uuid4, primary_key=True, editable=False, unique=True)

    class Meta:
        unique_together = [['owner', 'project']]

    def __str__(self):
    return self.value  # 此处存在缩进错误

ReviewForm表单代码 #

class ReviewForm(ModelForm):
    class Meta:
        model = Review 
        fields = ['value', 'body'] 

        labels = {
            'value' : 'Place your vote',
            'body' : 'Add a comment with your vote'
        }
    def __init__(self, *args, **kwargs):
        super(ReviewForm, self).__init__(*args, **kwargs)

        for name,field in self.fields.items():
            field.widget.attrs.update({'class': 'input'})

视图代码 #

def project(request,pk):
    projectObj = Project.objects.get(id=pk)
    form = ReviewForm()
    return render(request,'projects/single-project.html', {'project' : projectObj, 'form':form,})

模板代码（原错误版本） #

{% csrf_token %}
{% for field in form %}
<div class="form__field">
    <label for="formInput#textarea">{{field.label}}</label>
    {{field}}
</div>
{% endfor %}

错误分析与修复方案 #

1. 模型语法错误导致表单异常 #

Review模型的__str__方法存在缩进错误，return语句未缩进至方法体内，会触发Python语法错误，直接影响模型及关联表单的正常加载。

修复后的模型__str__方法：

def __str__(self):
    return self.value

2. 模板label关联优化（不影响标签显示，但提升可用性） #

原模板中label的for属性使用固定值，无法正确关联对应表单字段的输入框，点击标签无法聚焦到输入框。建议改为动态获取字段的ID属性。

修复后的模板代码：

{% csrf_token %}
{% for field in form %}
<div class="form__field">
    <label for="{{ field.id_for_label }}">{{ field.label }}</label>
    {{ field }}
</div>
{% endfor %}

3. 表单标签配置确认 #

当前ReviewForm的Meta类中labels配置完全正确，无需修改。修复上述两个问题后，自定义标签即可正常显示。

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