如何在 Django 中高效组织商品与分类数据并渲染到模板

本文讲解如何通过 django 的视图层预处理数据，将商品按分类分组后传递至模板，避免在模板中执行逻辑操作，从而正确实现“分类标题 + 对应商品列表”的结构化展示。

在 Django 开发中，模板（Template）不是用来编写业务逻辑的地方——它只负责展示数据。你尝试在模板中用 {% used_category = [] %} 初始化列表、进行条件判断和嵌套循环，这违反了 Django 的设计原则：模板语言不支持变量赋值、列表操作或复杂状态管理，因此会直接报 TemplateSyntaxError（如 Invalid block tag）。

正确的做法是：将数据组织逻辑移至视图（View）层，利用 Python 的强大能力完成分组，再将结构化数据安全、清晰地传给模板。

✅ 推荐方案：使用 itertools.groupby() 或字典预分组

首先确保模型间关系已正确定义（你的 ForeignKey 设置正确，但建议补充 related_name 并使用 select_related()/prefetch_related() 优化查询）：

# models.py（优化建议）
class Category(models.Model):
    name = models.CharField(max_length=64)  # 建议字段名语义化，避免 category.category

    def __str__(self):
        return self.name

class ShopItem(models.Model):
    name = models.CharField(max_length=64)  # 同上，避免 itemName
    price = models.DecimalField(max_digits=10, decimal_places=2)  # 建议用 DecimalField 存价格
    category = models.ForeignKey(
        Category,
        on_delete=models.CASCADE,
        related_name='items'  # 方便反向查询：category.items.all()
    )

    def __str__(self):
        return self.name

然后在视图中组织数据（推荐两种方式）：

方式一：按分类分组，返回 (category, item_list) 元组列表（推荐用于有序展示）

# views.py
from django.shortcuts import render
from django.db.models import Prefetch
from itertools import groupby
from operator import attrgetter

def shop_items_view(request):
    # 预加载分类信息，避免 N+1 查询
    items = ShopItem.objects.select_related('category').order_by('category__name', 'name')

    # 按 category 分组（需先排序）
    grouped_items = []
    for category, items_in_cat in groupby(items, key=attrgetter('category')):
        grouped_items.append((category, list(items_in_cat)))

    return render(request, 'shop/items_list.html', {
        'grouped_items': grouped_items,
    })

方式二：使用字典，更直观易读（适合中小数据量）

# views.py
def shop_items_view(request):
    items = ShopItem.objects.select_related('category').all()
    categories_dict = {}

    for item in items:
        cat = item.category
        if cat not in categories_dict:
            categories_dict[cat] = []
        categories_dict[cat].append(item)

    # 转为 (category, [items]) 列表，保持顺序可选 sorted(categories_dict.items())
    grouped_items = list(categories_dict.items())

    return render(request, 'shop/items_list.html', {
        'grouped_items': grouped_items,
    })

? 模板渲染（简洁、安全、无逻辑）

  {% for category, items_in_cat in grouped_items %}
    
    {% for item in items_in_cat %}
      
    {% endfor %}
  {% endfor %}

      
{{ category.name }}
    

        

        
{{ item.name }}
        
${{ item.price }}
      

✅ 优势总结：

• 零模板逻辑：无变量赋值、无状态维护，完全符合 Django 模板规范；
• 性能可控：select_related 避免 N+1 查询；
• 可维护性强：分组逻辑集中于视图，便于测试、调试与扩展（如添加分页、搜索过滤）；
• 语义清晰：grouped_items 直观表达“分类→商品”层级关系。

⚠️ 注意事项：

• 若分类数量极大且商品极多，考虑使用数据库原生分组（如 values('category__name').annotate(...)），但需权衡可读性；
• 模板中勿使用 {{ item.category.name }} 多次访问外键——因已 select_related，该属性是缓存的，但语义上仍建议用 item.category.name（而非 item.category 字符串化）；
• on_delete=models.CASCADE 是合理选择，但上线前务必确认删除级联是否符合业务预期。

遵循 MVT 分离原则，让 View 做数据准备，Template 专注呈现——这才是 Django 高效、稳健的开发之道。