Django 2.0类视图传递查询集至模板失败及视图优势咨询

先帮你排查查询集不显示的问题，这是Django类视图新手常遇到的坑，咱们一步步来：

一、排查查询集无法传递的可能原因 #

1. 确认类视图类型及上下文变量名 #

如果你用的是Django内置的ListView（最适合列表展示的类视图），它默认会把查询集以object_list的名字传到模板里；如果你想自定义变量名，得在类里指定context_object_name，比如：

from django.views.generic import ListView
from .models import Job

class JobListView(ListView):
    model = Job
    context_object_name = 'jobs'  # 这样模板里就能用{{ jobs }}调用查询集了
    template_name = 'joblist.html'

要是你没设置context_object_name，却在模板里用了{{ jobs }}，那肯定拿不到数据——得用默认的{{ object_list }}才行。

如果你用的是TemplateView这类基础类视图，必须手动重写get_context_data方法把查询集加到上下文里，否则模板根本看不到这个变量：

from django.views.generic import TemplateView
from .models import Job

class JobListTemplateView(TemplateView):
    template_name = 'joblist.html'

    def get_context_data(self, **kwargs):
        # 先调用父类方法获取默认上下文
        context = super().get_context_data(**kwargs)
        # 把查询集添加到上下文
        context['jobs'] = Job.objects.all()
        return context

2. 检查路由配置是否正确 #

确保你的路由是用.as_view()把类视图转换成可调用的视图函数，比如：

# urls.py
from django.urls import path
from .views import JobListView

urlpatterns = [
    path('joblist/', JobListView.as_view(), name='job-list'),
]

要是漏了.as_view()，服务器会直接报错，但如果路由指向了错误的视图类，也可能导致上下文不对。

3. 验证查询集是否真的能获取到数据 #

可以在类视图里加个打印语句确认数据：

class JobListView(ListView):
    model = Job

    def get_queryset(self):
        queryset = super().get_queryset()
        print(f"查询到的记录数：{queryset.count()}")  # 控制台会输出数量
        return queryset

运行服务器后访问/joblist/，看看控制台是不是输出10000左右的数字——如果没有，可能是模型类和数据库的映射有问题，或者你查询的模型不对。

4. 模板变量引用是否正确 #

模板里的变量名要和上下文里的完全一致，而且Django模板变量是大小写敏感的！比如上下文里是jobs，模板里写成Jobs就不行；如果用ListView默认的object_list，模板里就得写：

{% for job in object_list %}
    <p>{{ job.title }}</p>
{% endfor %}

另外，也可以在模板里用{{ debug }}（需要在settings里开启DEBUG=True）查看所有上下文变量，确认你的查询集是否在里面。

二、类视图相对于函数视图的优势 #

作为常年用Django开发的人，我更偏爱类视图，主要因为这几点：

• 代码复用性拉满：类视图支持继承和Mixin组合，比如你有10个视图都需要登录验证，只要写一个继承LoginRequiredMixin的基类，其他视图直接继承它就行，不用给每个函数视图加@login_required装饰器。
• 逻辑拆分更清晰：函数视图里要靠if request.method == 'GET'来区分请求方法，类视图直接把GET、POST等请求拆成get()、post()方法，代码结构一目了然，后期维护起来太省心了。
• 内置通用视图省时间：Django提供了ListView、DetailView、CreateView等通用类视图，已经封装了列表展示、详情页、数据创建这些常用逻辑，不用自己写查询集、模板渲染、表单验证的重复代码，开发效率提升一大截。
• 扩展性极强：通过Mixin可以灵活组合功能，比如要给列表视图加分页、权限控制、搜索过滤，只要把PaginationMixin、PermissionRequiredMixin这些加到继承列表里就行，不用修改核心逻辑。

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