Django中如何在单个模板中处理多模型与查询集并展示关联数据

架构老林

2026-4-22

嗨，我来帮你搞定这个在Django里用单个模板展示多模型关联数据的需求！你的场景是要在联系人列表里同时展示Lead的基础信息、对应的LeadStatus状态，还有针对该Lead的最新ActionWithLead动作，咱们一步步来解决。

首先，先给你提个小bug：你的ActionWithLead模型里的外键关联错啦，现在关联的是User，但你实际应该关联Lead对吧？先把这个修正过来，不然后续关联数据会出问题：

# 修正后的ActionWithLead模型
class ActionWithLead(models.Model):
    # 把ForeignKey的关联对象从User改成Lead
    lead = models.ForeignKey(Lead, on_delete=models.CASCADE)
    name = models.CharField(max_length=255, null=False)
    is_done = models.BooleanField(default=False)
    created = models.DateField(auto_now_add=True)

    def __str__(self):
        return f"{self.lead} - {self.name}"

接下来是视图部分，为了高效获取关联数据（避免频繁查询数据库的N+1问题），我们可以用select_related（针对一对一/外键关联的LeadStatus）和annotate来直接在查询集里获取最新的Action记录：

from django.db.models import Max, F
from django.shortcuts import render
from .models import Lead

def contactList(request):
    # 获取当前用户的所有Lead，同时关联LeadStatus
    # 用annotate标注每个Lead对应的最新Action的创建时间和名称
    contacts = Lead.objects.filter(user=request.user).select_related('leadstatus').annotate(
        latest_action_created=Max('actionwithlead__created'),
        latest_action_name=F('actionwithlead__name')
    ).order_by('-created')  # 按创建时间倒序，最新的联系人在前

    return render(request, '你的模板路径.html', {'contacts': contacts})

然后是模板部分，现在每个contact对象已经关联了leadstatus，还有我们标注的最新动作信息，直接在模板里调用就行，记得处理可能为空的情况（比如某个Lead还没创建LeadStatus或者Action的话）：

<tbody>
{% for contact in contacts %}
<tr>
    <!-- Lead基础信息 -->
    <td>{{ contact.lastname }}</td>
    <td>{{ contact.firstname }}</td>
    <td>{{ contact.email }}</td>
    <td>{{ contact.phone|default:"无" }}</td>
    <td>{{ contact.city|default:"无" }}</td>
    <td>{{ contact.created|date:"Y-m-d" }}</td>

    <!-- LeadStatus关联信息 -->
    {% with status=contact.leadstatus %}
    <td>{{ status.leadsource|default:"未设置" }}</td>
    <td>{% if status.traditionalBuyer %}是{% else %}否{% endif %}</td>
    <td>{% if status.businessProvider %}是{% else %}否{% endif %}</td>
    <td>{{ status.interest|default:"未知" }}</td>
    <td>{{ status.lastUpdated|date:"Y-m-d"|default:"无" }}</td>
    {% endwith %}

    <!-- 最新ActionWithLead信息 -->
    <td>
        {% if contact.latest_action_name %}
            {{ contact.latest_action_name }}（{{ contact.latest_action_created|date:"Y-m-d" }}）
        {% else %}
            暂无动作
        {% endif %}
    </td>
</tr>
{% endfor %}
</tbody>

这里给你解释几个关键细节：

select_related('leadstatus')：因为Lead和LeadStatus是一对一关联，用这个可以一次性把Lead对应的LeadStatus数据查出来，不用每个循环都单独查询数据库，提升性能。
annotate逻辑：通过Max函数获取每个Lead对应的Action的最新创建时间，再用F对象关联对应的动作名称，这样模板里直接就能调用，不用额外处理。
模板里的{% with %}标签：用来简化重复的变量调用，让代码更整洁；|default:"xxx"过滤器则是处理字段为空的情况，避免页面显示空白或者报错。

如果之后你需要展示完整的Action对象（比如判断动作是否完成），也可以用Prefetch方法来精准筛选最新的动作记录，再传递到模板里调用。

备注：内容来源于stack exchange，提问作者Ramzouu