如何在Django的HTML模板中解析一对多关系的多值数据？

我在Django中定义了一对多关系：

class Listing(models.Model):
    title = models.CharField(max_length=60)

class Images(models.Model):
    listings = models.ForeignKey(Listing, on_delete=models.CASCADE)
    image_urls = models.URLField(max_length = 200)

同时定义了视图：

from .models import Listing, Images

def index(request):
    All_Listings = Listing.objects.filter(isActive=True)
    return render(request, "index.html", {
        "All_Listings": All_Listings,
        "Images" : Images
    })

想要在HTML模板中为每个Listing展示其所有关联的Images，尝试了以下模板代码：

{% extends "layout.html" %}

{% block body %}
{% for listing in All_Listings %}
<h2>{{ list(Images.objects.filter(listings_id=2))  }}</h2>
{% endfor%}
{% endblock %}

（原本打算后续把2替换为listing.id）

但返回错误：

Exception Type:     TemplateSyntaxError
Exception Value:    Could not parse the remainder: '(Images.objects.filter(listings_id=2))' from 'list(Images.objects.filter(listings_id=2))'

不过在终端执行list(Images.objects.filter(listings_id=2))能正常返回结果。

请问该如何正确实现需求？

Django模板语法不支持直接执行list()这类Python内置函数，也不推荐在模板中直接调用模型的objects.filter()方法，正确做法是利用Django的反向关联特性，或在视图中提前预加载关联数据。

方法1：使用反向关联（推荐） #

Django会自动为外键关系生成反向关联属性，默认名称为模型名小写_set，这里就是images_set，可直接通过listing对象在模板中访问：

修改模板代码如下：

{% extends "layout.html" %}

{% block body %}
{% for listing in All_Listings %}
    <h2>{{ listing.title }}</h2>
    {% for image in listing.images_set.all %}
        <img src="{{ image.image_urls }}" alt="Listing image">
    {% endfor %}
{% endfor%}
{% endblock %}

如果觉得images_set名称不够直观，可在定义外键时通过related_name自定义名称：

class Images(models.Model):
    listings = models.ForeignKey(Listing, on_delete=models.CASCADE, related_name="images")
    image_urls = models.URLField(max_length = 200)

之后模板中即可用listing.images.all访问关联图片：

{% for image in listing.images.all %}
    <img src="{{ image.image_urls }}" alt="Listing image">
{% endfor %}

方法2：视图中预加载关联数据（优化性能） #

直接使用反向关联会触发N+1查询（每个Listing单独查询一次Images），可在视图中用prefetch_related预加载所有关联数据，提升查询效率：

def index(request):
    # 预加载关联的Images，避免N+1查询
    All_Listings = Listing.objects.filter(isActive=True).prefetch_related('images_set')
    # 若设置了related_name="images"，则改为prefetch_related('images')
    return render(request, "index.html", {
        "All_Listings": All_Listings,
    })

模板代码与方法1一致即可，这样只会执行2次数据库查询（一次查Listing，一次查所有关联的Images），比N+1查询高效得多。

为什么模板中不能直接用list(Images.objects.filter(...))？ #

Django模板语言做了语法限制，不允许直接执行Python函数调用（仅支持少数内置过滤器和标签），目的是分离业务逻辑与视图展示，让模板只负责渲染数据，数据查询逻辑应放在视图或模型层。

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