如何在 Django 中正确实现按分类分组展示商品（避免模板中直接操作逻辑）

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

✅ 模板写法（简洁、安全、无逻辑错误）

  {% for category, items in categorized_items.items %}
    
    {% for item in items %}
      
    {% endfor %}
  {% endfor %}

      
{{ 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'),

遵循“模板只负责展示，逻辑交给视图”的原则，不仅能解决当前问题，更能提升代码可维护性与团队协作效率。