django 模板层不支持变量赋值和复杂逻辑处理，应通过视图预处理数据（如按分类聚合商品），再传递给模板渲染，以实现清晰、高效、符合 mvt 规范的分类展示。
在 Django 中，不能在模板中声明变量（如 {% used_category = [] %}）或执行 Python 式的逻辑操作——这正是你遇到 TemplateSyntaxError: Invalid block tag 的根本原因。Django 模板语言是故意设计为“逻辑受限”的：它只支持条件判断（{% if %}）、循环（{% for %}）、过滤器和标签（如 {% url %}），不支持赋值、列表操作、状态跟踪等编程行为。
✅ 正确做法：将分组逻辑移至视图层，利用 Django ORM 高效预聚合数据。
✅ 推荐方案：使用 prefetch_related() + 字典分组（推荐初学者）
# views.py
from django.shortcuts import render
from .models import Category, ShopItem
def shop_items_by_category(request):
# 获取所有分类及对应商品（一次查询优化）
categories = Category.objects.prefetch_related('shopitem_set').all()
# 构造 {category: [item1, item2, ...]} 结构（可选，便于模板理解）
categorized_items = {}
for cat in categories:
categorized_items[cat] = list(cat.shopitem_set.all())
return render(request, 'shop/items_by_category.html', {
'categorized_items': categorized_items,
})同时，需在 Category 模型中显式定义反向关系名（更清晰）：
# models.py
class Category(models.Model):
category = models.CharField(max_length=64)
def __str__(self):
return self.category
class ShopItem(models.Model):
itemName = models.CharField(max_length=64)
price = models.IntegerField()
# 推荐添加 related_name，避免默认的 shopitem_set
category = models.ForeignKey(
Category,
on_delete=models.CASCADE,
related_name='items' # ← 关键：统一命名反向关系
)
def __str__(self):
return self.itemName✅ 模板写法（简洁、安全、无逻辑错误）
| {{ category.category }} | ||
|---|---|---|
| {{ item.itemName }} | ${{ item.price }} | |
⚠️ 注意事项与进阶建议
- 不要在模板中尝试模拟“已使用分类”逻辑：Django 模板没有作用域、不可变变量、无副作用限制，强行绕过会导致难以调试的错误。
- 性能优化：使用 prefetch_related('items') 可避免 N+1 查询问题（相比在模板中反复访问 item.category）。
- 替代方案（高级）：若需更灵活的分组（如仅显示有商品的分类），可用 ShopItem.objects.select_related('category').order_by('category__category')，再在视图中用 itertools.groupby() 分组。
-
URL 与路由：确保在 urls.py 中配置对应路径：
path('shop/', views.shop_items_by_category, name='shop_items'),
遵循“模板只负责展示，逻辑交给视图”的原则，不仅能解决当前问题，更能提升代码可维护性与团队协作效率。
