Django ListView使用教程：快速实现文章列表与分页

Django的ListView看似开箱即用，实则暗藏诸多易踩坑点：从空数据导致的EmptyResultSet报错、分页失效的URL参数丢失，到动态筛选时queryset构造不当、模板中分页链接覆盖原有搜索条件——每一步都需精准把控。本文直击实战痛点，手把手教你通过显式定义queryset、重写get_queryset()实现时间排序/搜索/标签筛选，并安全保留URL查询参数渲染分页链接，让ListView真正稳定、灵活、可扩展地服务于真实项目需求。

ListView 为什么一配就报错 EmptyResultSet

常见现象是页面空白或直接抛出 EmptyResultSet，其实不是代码写错了，而是 queryset 或 model 配置没对上。Django 的 ListView 默认要求模型有数据，且必须明确指定数据源。

• 如果只写了 model = Article，但数据库里没数据，它不会静默跳过，而是直接报错——这不是 bug，是设计行为
• 更稳妥的做法是显式定义 queryset，哪怕只是 Article.objects.all()，这样逻辑更可控
• 注意 get_queryset() 方法返回空 QuerySet（比如 .filter(title__icontains="")）也会触发该错误，得用 .none() 或加兜底判断

分页参数怎么传、在哪改、为什么改了没反应

分页不是开箱即用的魔法，ListView 默认启用分页，但有两个关键点卡住效果：一是请求 URL 没带 page 参数，二是模板里没调用分页对象。

• paginate_by = 10 写在类里即可生效，但仅当视图收到形如 ?page=2 的 GET 请求时才真正分页
• 模板中必须用 page_obj（不是 object_list）来取当前页数据，比如 {% for article in page_obj %}
• 如果手动重写了 get_queryset()，记得别漏掉 return super().get_queryset() 或等效逻辑，否则分页器拿不到原始 QuerySet

怎么让 ListView 显示最新文章、带搜索、还支持标签筛选

单一 queryset 不够用？那就用 get_queryset() 动态构造——这是最自然的扩展方式，比堆砌多个类属性更清晰。

• 按时间倒序：直接 return Article.objects.order_by("-created_at")
• 加搜索：从 self.request.GET.get("q") 取关键词，用 .filter(title__icontains=q)，注意判空避免全表扫描
• 标签筛选：假设 URL 是 /articles/?tag=python，就 .filter(tags__slug=self.request.GET.get("tag"))，前提是 tags 是外键或 ManyToManyField
• 所有这些操作都在 get_queryset() 里链式调用，Django 分页器会自动作用于最终结果

模板里怎么安全渲染分页链接，避免 URL 冲突

直接写 ?page=2 很危险——当前 URL 如果已有查询参数（比如 ?q=django&tag=web），硬编码会把它们全干掉。

• Django 自带 page_obj.paginator.get_page_number() 不管用，得靠模板里的 page_obj 和 request.GET
• 推荐做法：在视图里把干净的查询参数传给模板上下文，比如 context["params"] = request.GET.copy()，然后在模板中 {% if params.has_key "page" %}{{ params.urlencode }}{% else %}{{ params.urlencode }}&page=2{% endif %}
• 更省事的是用第三方库 django-url-filter 或手写一个 url_replace 模板过滤器，专为保留原有参数而生

最容易被忽略的是：分页器默认只认 page 这个参数名，如果你改成 paginate_by = 20 却忘了检查前端是否同步传 page，那永远只显示第一页。

好了，本文到此结束，带大家了解了《Django ListView使用教程：快速实现文章列表与分页》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！