作为一个 Web 开发者，你一定遇到过这样的情况：从数据库中查询到了成百上千条数据，但直接将它们全部倾倒在一个页面上不仅会让用户眼花缭乱，还会导致页面加载极其缓慢。这就是为什么我们需要“分页”功能。分页不仅能够提升用户体验，还能有效减轻服务器负担。
在 Django 的世界里，我们不需要重复造轮子去手动计算偏移量。Django 为我们提供了一个内置且功能强大的工具——Paginator 类。在这篇文章中，我们将作为并肩作战的开发者，一起深入探讨如何在 Django 项目中高效地实现分页功能。我们会从基础概念讲起，通过实际的代码示例，逐步深入到高级用法、错误处理以及性能优化。
认识 Django 的 Paginator 类
在开始写代码之前，让我们先搞清楚 INLINECODEbf677c00 到底是什么。简单来说，INLINECODE54b6205b 是 Django 核心代码中的一个类（位于 django.core.paginator），它的作用就像是一个无形的切割机，能够将一个包含大量数据的列表、元组或数据库查询集，自动切分成一个个小的“页面”对象。
为什么使用内置分页？
虽然我们可以手动编写 SQL 语句（如 INLINECODE320e8e1a 和 INLINECODE437360e3）来实现分页，但这很容易出错，且需要处理大量的边缘情况（例如：用户请求的页码不存在怎么办？数据量刚好整除怎么办？）。使用 Django 内置的 Paginator，我们可以专注于业务逻辑，将繁琐的数学计算交给框架去处理。
核心组件：导入与初始化
要使用分页器，我们首先需要从 Django 中引入必要的类。通常，我们会导入 Paginator 本身以及两个关键的异常类，用于处理用户输入非法页码的情况：
from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger
基本用法解析
初始化一个分页器非常简单，只需两步：准备数据，然后创建实例。
# 假设我们有一个包含 100 个对象的列表或查询集
list_of_objects = MyModel.objects.all()
# 创建 Paginator 实例
# 参数 1: 要分页的数据集合
# 参数 2: 每页显示的对象数量
p = Paginator(list_of_objects, 10)
在这段代码中，p 就是一个分页器实例。它并不会真正去查询数据库（除非传入的是 QuerySet），而是准备好了一切逻辑。
深入理解构造参数
除了基础的数据和数量，Paginator 还接受一些可选参数，掌握这些参数能让你的分页更加人性化：
- orphans (孤儿数据): 这是一个非常实用的参数。
场景*: 假设每页显示 10 条数据，最后一页只有 1 条数据。用户点开最后一页，只看到孤零零的一条记录，体验并不好。
设置*: 如果设置 orphans=3，意味着如果最后一页的数据量小于等于 3，这些数据会被自动合并到上一页，避免出现“极短的”最后一页。默认为 0。
- allowemptyfirst_page (允许首页为空):
* 默认为 True。即使没有数据，第一页也能显示。
* 如果设置为 INLINECODE3309ddfd，且数据集为空，访问第一页会抛出 INLINECODE55d35159 异常。通常保持默认即可。
动手实战：构建一个带有分页的博客列表
理论讲完了，让我们把双手放在键盘上，通过构建一个实际的博客列表页来掌握这项技能。我们将从头开始，涵盖模型创建、视图逻辑以及模板展示。
第一步：准备项目与环境
首先，确保你已经创建了一个 Django 项目和应用。如果你还没有，请运行以下命令：
django-admin startproject myproject
cd myproject
python manage.py startapp blog
第二步：定义数据模型
为了演示，我们需要一个数据源。在你的 INLINECODE10bda55e 中定义一个简单的 INLINECODEf22ba537 模型：
from django.db import models
class Post(models.Model):
title = models.CharField(max_length=200)
author = models.CharField(max_length=100)
content = models.TextField()
published_date = models.DateTimeField(auto_now_add=True)
def __str__(self):
return self.title
第三步：编写视图逻辑（核心部分）
这是分页功能发生的地方。我们需要在 INLINECODE34df66ca 中获取数据，并将其分页。打开 INLINECODE28b32090，输入以下代码。请注意代码中的详细注释，它们解释了每一步的意图。
from django.shortcuts import render
from .models import Post
from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger
def index(request):
# 1. 获取所有文章数据
# 在生产环境中，为了性能，通常不会直接 .all()，而是结合 select_related 或 prefetch_related
posts_list = Post.objects.all().order_by(‘-published_date‘)
# 2. 实例化 Paginator
# 我们将每页显示 5 篇文章
paginator = Paginator(posts_list, 5)
# 3. 获取当前请求的页码
# request.GET.get(‘page‘) 会尝试从 URL 参数中获取 ?page=1 的值
page_number = request.GET.get(‘page‘)
# 4. 获取具体的页面对象
# 这里我们使用 try-except 块来优雅地处理错误
try:
# 如果 page_number 是有效的整数且在范围内，返回对应页
page_obj = paginator.page(page_number)
except PageNotAnInteger:
# 如果 page_number 不是整数（例如 ‘abc‘），则返回第一页
page_obj = paginator.page(1)
except EmptyPage:
# 如果 page_number 超出范围（例如请求第 9999 页，但只有 10 页），
# 则返回最后一页
page_obj = paginator.page(paginator.num_pages)
# 5. 将页面对象传递给模板
# 注意：我们传递的是 page_obj，而不是 posts_list
context = {‘page_obj‘: page_obj}
return render(request, ‘blog/index.html‘, context)
实用见解： 你可能会问，为什么我们要手动处理 INLINECODE7fcb37b0 和 INLINECODEe5d14757 异常？实际上，Django 提供了一个更简便的方法 get_page()，它会自动处理这些边缘情况。如果你的逻辑不需要特殊的错误处理，上面的代码可以简化为：
# 更简洁的写法
page_number = request.GET.get(‘page‘)
page_obj = paginator.get_page(page_number)
# get_page 会自动处理无效输入：如果不是整数返回第一页，如果超出范围返回最后一页
第四步：创建模板
视图准备好了，现在我们需要在前端展示数据。在你的 blog/templates/blog/index.html 中：
博客列表
最新文章
{% for post in page_obj %}
{{ post.title }}
作者: {{ post.author }}
{{ post.content }}
{% endfor %}
进阶技巧与性能优化
仅仅能跑通是不够的，作为专业的开发者，我们需要考虑代码的健壮性和性能。以下是我们在实战中总结的经验。
1. 使用 ListView 通用视图简化代码
如果你使用的是基于类的视图，Django 的 INLINECODEe63a4bc9 已经内置了对分页的支持。你甚至不需要手动导入 INLINECODE98e620d1！
from django.views.generic import ListView
from .models import Post
class PostListView(ListView):
model = Post
template_name = ‘blog/index.html‘
context_object_name = ‘posts‘ # 默认是 object_list
paginate_by = 5 # 只需要设置这一行，Django 会自动处理分页！
ordering = ‘-published_date‘
注意: 当使用 INLINECODE4d20ef8f 分页时，模板中的上下文变量名默认为 INLINECODEb39eead9，或者是 INLINECODEcb2b7d59 (布尔值) 和 INLINECODEdb566efe。你需要根据实际调整模板代码。
2. 性能优化：避免 N+1 查询问题
在视图中使用 INLINECODEe6be9fc7 时，如果你在模板中访问了外键字段（例如 INLINECODEac0a1044），Django 默认会对每个对象执行一次额外的查询。如果有 100 条数据，这会导致 101 次数据库查询！
解决方案: 在分页之前，使用 INLINECODE1fb124f7 或 INLINECODEa50c7ce7。
# 优化后的查询
posts_list = Post.objects.all().select_related(‘author‘).prefetch_related(‘tags‘)
paginator = Paginator(posts_list, 5)
这样做，无论分页多少页，数据库查询次数都会保持在一个常数级别，极大地提升页面加载速度。
3. URL 参数的保留
在实际应用中，URL 可能包含其他查询参数，例如搜索关键词 INLINECODE9edfb6d3。如果我们的分页链接只写 INLINECODE3e42181b，点击后就会丢失搜索关键词。
解决方案: 在模板中构建链接时，保留当前的 GET 参数。
下一页
这样，用户的搜索状态就不会因为翻页而丢失了。
常见问题与解决方案
在开发过程中，我们遇到了一些有趣的坑，这里分享出来希望能帮你节省调试时间。
- Q: 分页不生效，一直显示所有数据？
* A: 检查你的模板，确保你遍历的是 INLINECODE0aab9810 或 INLINECODE552853b4，而不是原始的 QuerySet。另外，确认在视图中确实将 page_obj 传递给了上下文。
- Q: 使用
Paginator后报错 ‘TypeError: object of type … has no len()‘？
* A: INLINECODE3deb88f7 需要传入的对象是可以计算长度的（实现了 INLINECODE4569e697）或者是可切片的。确保你传入的是 QuerySet 或列表，而不是单个对象。
- Q: 如何实现“上一页/下一页”而不是显示所有页码？
* A: 当数据量非常大时（例如 10,000 页），显示所有页码是个灾难。我们在上面的模板示例中使用了 INLINECODE9dcaf963 和 INLINECODEa2dd0705，这可以构建一个简单的导航。如果你想做像 Google 那样的“1, 2, 3 … 10 11 12 … 99 100”效果，你需要编写自定义的模板标签来计算页码范围，这超出了基础分页的范畴，但绝对值得深入研究。
结语
至此，我们已经完整地掌握了在 Django 中添加分页功能的全过程。从最初理解 Paginator 类的基本构造，到在视图中处理复杂的边缘情况，再到模板中构建用户友好的导航栏，甚至是优化底层查询性能，这些技能将使你构建的 Web 应用更加专业和高效。
分页看似简单，却是连接后端数据与前端体验的重要桥梁。下次当你面对海量数据时，不要犹豫，自信地使用 Django 强大的分页工具来解决问题吧！祝你编码愉快！