Django模板未按预期渲染模型：分类展示课程问题

这个问题我之前也碰到过，核心就是要把同分类的课程先归组，再渲染，这样每个分类就只会显示一次啦！给你两种常用的解决方案：

方法一：使用Django模板的{% regroup %}标签 #

这个方法不需要修改视图逻辑，直接在模板里处理分组，但要确保你的lectures查询集是按lecture_category排序的（否则同分类的课程会被拆到不同组）。

第一步：确保查询集有序 #

在视图中传递lectures时，加上排序：

# 示例视图代码
def your_view(request):
    # 如果是关联Course的lectures，就用course.lectures.all().order_by('lecture_category')
    lectures = Lecture.objects.all().order_by('lecture_category')
    return render(request, 'your_template.html', {'lectures': lectures})

第二步：修改模板代码 #

用{% regroup %}把同分类的课程归到一起，再嵌套循环渲染：

<ul>
{% regroup lectures by lecture_category as category_groups %}
{% for category in category_groups %}
  <li>
    <!-- 显示分类名称：通过判断grouper的值映射显示文本 -->
    <b>{% if category.grouper == 0 %}Classes{% else %}Seminars{% endif %}</b>
    <p>.......................</p>
    <ul>
      <!-- 循环渲染当前分类下的所有课程 -->
      {% for lecture in category.list %}
        <li>{{ lecture.lecture_title }}</li>
        <li>{{ lecture.content }}</li>
        {% if lecture.link %}
          <li>{{ lecture.link }}</li>
          {% if lecture.file %}
            <li><a href='{{ MEDIA_URL }}{{ lecture.file.url }}'>download</a></li>
          {% endif %}
        {% endif %}
      {% endfor %}
    </ul>
  </li>
{% endfor %}
<hr/>
</ul>

方法二：在视图中用itertools.groupby提前分组 #

这种方法逻辑更清晰，能直接拿到分类的显示名称，适合需要对分组做更多自定义处理的场景。

第一步：修改视图代码 #

导入itertools.groupby，对查询集排序后分组，把分组结果传递给模板：

from itertools import groupby
from django.shortcuts import render, get_object_or_404
from .models import Lecture, Course

def your_view(request, course_id=None):
    if course_id:
        # 如果是从Course关联的lectures
        course = get_object_or_404(Course, pk=course_id)
        lectures = course.lectures.all().order_by('lecture_category')
    else:
        lectures = Lecture.objects.all().order_by('lecture_category')
    
    # 按分类的显示名称分组
    grouped_lectures = []
    for category_name, lecture_group in groupby(lectures, key=lambda x: x.get_lecture_category_display()):
        grouped_lectures.append({
            'category_name': category_name,
            'lectures': list(lecture_group)
        })
    
    return render(request, 'your_template.html', {'grouped_lectures': grouped_lectures})

第二步：修改模板代码 #

直接循环提前分好的组，逻辑更简洁：

<ul>
{% for group in grouped_lectures %}
  <li>
    <b>{{ group.category_name }}</b>
    <p>.......................</p>
    <ul>
      {% for lecture in group.lectures %}
        <li>{{ lecture.lecture_title }}</li>
        <li>{{ lecture.content }}</li>
        {% if lecture.link %}
          <li>{{ lecture.link }}</li>
          {% if lecture.file %}
            <li><a href='{{ MEDIA_URL }}{{ lecture.file.url }}'>download</a></li>
          {% endif %}
        {% endif %}
      {% endfor %}
    </ul>
  </li>
{% endfor %}
<hr/>
</ul>

关键提醒 #

不管用哪种方法，一定要先对查询集按lecture_category排序！因为分组操作依赖有序的数据，如果不排序，同分类的课程会被分到多个组里，还是会重复显示分类名称。

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