如何在Django模板中通过条件判断获取Box模型的默认图片路径

核心问题说明 #

Django 模板语法不支持直接在方法调用时传递参数，所以你尝试在模板中调用 filter() 并传入筛选条件的写法无法生效。

以下是三种可行的实现方案，按推荐优先级排序：

方案1：模型层增加属性（最推荐，使用最简洁） #

在你的 Box 模型中新增一个只读属性，封装默认图片的查询逻辑：

class Box(models.Model):
    # 原有字段保持不变
    boxName = models.CharField(max_length=255, blank = False)
    # ... 其他原有字段

    # 新增默认图片属性
    @property
    def default_image(self):
        return self.images.filter(defaultImage=True).first()

模板中直接调用该属性即可，不需要循环：

<!-- 替换原有图片循环的代码 -->
{% if item.default_image %}
<img src="{{ item.default_image.image.url }}" alt="{{ item.default_image.imageMetaDescription }}">
{% endif %}

方案2：模板循环加条件判断（无需修改后端代码） #

如果不想修改模型和视图，可以在遍历关联图片时增加条件判断，仅渲染默认图片：

{% for image in item.images.all %}
  {% if image.defaultImage %}
    <img src="{{ image.image.url }}" alt="{{ image.imageMetaDescription }}">
  {% endif %}
{% endfor %}

注意：该方案会遍历Box的所有关联图片，关联图片量大时性能较低。

方案3：视图层预查询优化（性能最优） #

如果页面Box数量较多，为了避免N+1查询问题，可以在视图层用 Prefetch 提前过滤并预加载默认图片：

# 视图层导入必要模块
from django.db.models import Prefetch
from box.models import BoxImage

class MainShop(View):
    def get(self, request, *args, **kwargs):
        self.context['title'] = 'Dimsum Box Shop'
        # 替换原有Box查询语句
        self.context['boxes'] = Box.objects.prefetch_related(
            Prefetch('images', queryset=BoxImage.objects.filter(defaultImage=True), to_attr='default_images')
        ).all()
        return render(request, template_name='mainShop.html', context = self.context)

模板中直接遍历预查询好的默认图片列表即可：

{% for image in item.default_images %}
  <img src="{{ image.image.url }}" alt="{{ image.imageMetaDescription }}">
{% endfor %}

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