本文讲解如何通过 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,
})? 模板渲染（简洁、安全、无逻辑）
| {{ 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 高效、稳健的开发之道。
