Django使用ModelForm时如何在模板中访问外键关联字段

{{ form.parent }} 是Django表单渲染的BoundField外键选择字段对象，并非表单绑定的ChildModel实例本身，直接通过{{ form.parent.name }}取值无法定位到关联ParentModel的name属性，因此触发上下文查找失败报错。

分两种常见需求场景处理：

场景1：单独展示当前子实例关联的父模型name值 #

通过form.instance获取表单绑定的模型实例，再跨外键关联取属性即可，模板代码修改如下：

<form method="POST" action="">
   {% csrf_token %}
   <!-- 展示关联父项名称，空值时显示默认文本避免报错 -->
   <p>关联父项：{{ form.instance.parent.name|default:"未关联父项" }}</p>
   <!-- 正常渲染外键选择下拉框 -->
   {{ form.parent }}
   <button type="submit">Save</button>
</form>

提示：未绑定实例的空表单（新建场景下）form.instance.parent为空，加default过滤器可以避免空值报错。

场景2：外键下拉选择框选项显示name，而非默认pk #

外键下拉选项默认取模型__str__方法的返回值作为显示文本，你当前代码显示pk是因为模型定义存在两处语法问题导致__str__未生效：

• CharField必须指定max_length参数
• Django 2.0+版本ForeignKey必须指定on_delete规则

修正后的models.py代码：

class ParentModel(models.Model):
    name = models.CharField(max_length=100, verbose_name="父项名称")
    
    def __str__(self):
        return self.name

class ChildModel(models.Model):
    parent = models.ForeignKey(ParentModel, on_delete=models.CASCADE, verbose_name="关联父项")
    
    def __str__(self):
        return self.parent.name

完成模型修正并执行迁移后，下拉选项会自动显示ParentModel的name字段值。如果不想修改模型__str__方法，也可以直接在表单内自定义选项显示规则，修改forms.py：

class ChildModelForm(ModelForm):
    parent = forms.ModelChoiceField(
        queryset=ParentModel.objects.all(),
        widget=forms.Select(),
        # 自定义选项显示文本，直接返回父项的name值
        label_from_instance=lambda obj: obj.name
    )
    class Meta:
        model = ChildModel
        fields = '__all__'

• 视图查询逻辑修正：ChildModel.objects.get(parent=pk)会查询所有关联了id为pk的父项的子实例，若存在多个子项关联同一父项会触发MultipleObjectsReturned报错。如果路由传入的pk是子项id，应改为child = ChildModel.objects.get(pk=pk)。
• 视图表单逻辑简化，避免重复实例化表单：

def childView(request, pk):
    template = 'template.html'
    child = ChildModel.objects.get(pk=pk)
    # 同时兼容GET/POST请求的表单实例化
    form = ChildModelForm(request.POST or None, instance=child)
    if request.method == 'POST' and form.is_valid():
        form.save()
    context = {'form': form}
    return render(request, template, context)

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