Django分页：paginator与page_obj如何注入模板上下文？

我来帮你拆解一下这个问题——在Django里，paginator和page_obj注入模板上下文主要有两种场景，对应你提到的官方文档实现和自定义包含标签的实现：

1. Django ListView 的默认注入逻辑 #

如果你的「专家」列表页是基于Django自带的ListView实现的，那这两个变量的注入其实是框架自动完成的：

• ListView继承自MultipleObjectMixin，这个混入类专门处理多对象查询的分页逻辑
• 在视图的get_context_data()方法中，MultipleObjectMixin会自动将以下变量添加到模板上下文：
  • paginator：根据查询集和分页配置生成的Paginator实例
  • page_obj：当前请求对应的Page实例（包含当前页的数据）
• 你不需要手动做任何额外操作，直接在模板里引用{{ paginator }}和{{ page_obj }}就能使用

举个简单的ListView示例：

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

class ExpertListView(ListView):
    model = Expert
    paginate_by = 10  # 每页10条数据

在对应的模板里，你直接就能用page_obj.number（当前页码）、paginator.num_pages（总页数）这类属性。

2. 自定义paginator包含标签的注入逻辑 #

从你提供的代码片段来看，你用了自定义的包含标签（paginator），这种场景下的注入逻辑是在标签内部手动实现的：

• 自定义包含标签通常用@register.inclusion_tag装饰器定义，它会渲染一个指定的模板片段，并可以传递自定义上下文
• 你的标签代码里可能做了这些操作：
  1. 从请求参数中获取分页相关的参数（比如page页码），这也是你引入query_dict_from_params_or_co...的原因
  2. 手动创建Paginator实例，传入查询集和每页条数
  3. 根据页码参数获取对应的Page实例，处理EmptyPage这类异常（比如跳转到第一页或最后一页）
  4. 将生成的paginator和page_obj作为上下文变量返回，供包含的分页模板使用

举个自定义包含标签的大致实现示例：

from django import template
from django.core.paginator import Paginator, EmptyPage
from dashboard.views.utils import query_dict_from_params_or_co...

register = template.Library()

@register.inclusion_tag('pagination.html')
def paginator(request, queryset, per_page=10):
    # 从请求中获取页码参数
    page_num = request.GET.get('page', 1)
    # 创建分页器
    paginator = Paginator(queryset, per_page)
    try:
        page_obj = paginator.page(page_num)
    except EmptyPage:
        # 处理无效页码，比如返回最后一页
        page_obj = paginator.page(paginator.num_pages)
    # 返回上下文，供pagination.html使用
    return {
        'paginator': paginator,
        'page_obj': page_obj,
        'request': request  # 可能还需要传递request来生成带参数的分页链接
    }

在模板里调用这个标签时，你只需要传入request和查询集：

{% paginator request expert_list %}

这样pagination.html模板里就能直接使用paginator和page_obj这两个变量了。

总结一下：官方文档的方式是依赖ListView的Mixin自动注入上下文，而你现在用的自定义包含标签是在标签内部手动生成并传递这两个变量，灵活性更高，适合需要自定义分页逻辑的场景。

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