Django模板中正确遍历外键反向关联对象的做法

作者：袖梨 2026-08-15

本文解决Django模板中因变量名错误导致RelatedManager查询结果无法渲染的问题，重点说明choice_set.all遍历时的变量命名规范及常见陷阱。

本文解决Django模板中因变量名错误导致RelatedManager查询结果无法渲染的问题，重点说明`choice_set.all`遍历时的变量命名规范及常见陷阱。

在Django中，当通过外键（ForeignKey）建立模型关系后，Django会自动为关联模型提供反向关系管理器（如 question.choice_set）。但在模板中遍历这些关联对象时，循环变量名必须与实际使用的对象字段保持一致——这是初学者极易忽略的关键细节。

回顾问题中的模板代码：

<ul>{% for question in question.choice_set.all %}<li>{{ choice.choice_text }}</li>{% endfor %}</ul>

此处存在两个严重错误：

循环变量名冲突：{% for question in ... %} 将每个 Choice 实例错误地命名为 question，覆盖了外层传入的 Question 对象；
引用字段名不匹配：{{ choice.choice_text }} 中的 choice 变量根本未被定义，导致渲染为空。

正确写法应为：

<ul>{% for choice in question.choice_set.all %}<li>{{ choice.choice_text }}</li>{% endfor %}</ul>

choice 是循环中每个 Choice 模型实例的临时变量名；
choice.choice_text 才能正确访问该实例的 choice_text 字段；
同时确保 Choice 模型已正确定义 choice_text = models.CharField(...)，且数据库中对应记录非空。

? 额外建议与注意事项：

可在视图中预加载关联数据以提升性能（避免N+1查询）：

from django.db import modelsdef detail(request, question_id):question = get_object_or_404(Question.objects.prefetch_related('choice_set'),pk=question_id)return render(request, "polls/detail.html", {'question': question})

模板中可添加空值判断增强健壮性：

{% if question.choice_set.all %}<ul>{% for choice in question.choice_set.all %}<li>{{ choice.choice_text }}</li>{% endfor %}</ul>{% else %}<p>No choices available.</p>{% endif %}

若需自定义反向关系名称（如避免 choice_set），可在 ForeignKey 中设置 related_name：
```
class Choice(models.Model):question = models.ForeignKey(Question, on_delete=models.CASCADE, related_name='choices')# ...
```
此时模板中应使用 question.choices.all 替代 question.choice_set.all。