Django分类文章数量模板渲染失效问题求助

核心检查点 #

• 确认模板文件扩展名是.html：Django默认仅解析.html后缀的模板文件，其他扩展名会直接原样输出内容。
• 检查视图上下文传递：确保视图将分类数据传入模板，示例代码：

  # views.py
  from django.shortcuts import render
  from .models import Category
  
  def category_list(request):
      categories = Category.objects.all()
      # 注意上下文字典的键要和模板中遍历的变量名一致
      return render(request, 'your_template.html', {'categories': categories})
  

• 验证模板遍历逻辑：模板中需正确遍历分类列表，变量名要和上下文对应，示例：

  {% for category in categories %}
      <span>{{ category.name }} ({{ category.post_set.count }})</span>
  {% endfor %}
  

• 检查模板自动转义设置：如果模板中开启了{% autoescape on %}，会将模板变量转义为纯文本，可关闭自动转义或使用{{ category.post_set.count|safe }}（优先排查是否必要开启自动转义）。
• 确认模型关联关系：Post模型需正确设置到Category的外键，确保反向关联post_set存在：

  # models.py
  from django.db import models
  
  class Category(models.Model):
      name = models.CharField(max_length=100)
  
  class Post(models.Model):
      title = models.CharField(max_length=200)
      # 外键关联确保on_delete参数正确设置
      category = models.ForeignKey(Category, on_delete=models.CASCADE)
  

• 检查模板语法拼写：确保{{ category.post_set.count }}无拼写错误，花括号前后无多余干扰字符。

额外调试技巧 #

• 在视图中打印categories[0].post_set.count，确认后端能正常获取数量，排除模型关联问题。
• 先在模板中输出{{ category.name }}，若该内容也不显示，说明上下文传递有误；若能显示，再聚焦排查post_set.count的问题。

内容的提问来源于stack exchange，提问作者Daniel Choi최다니엘