Pagination 将大量结果集分成离散的页面，这样您就不会一次加载数千条记录。这对性能和可用性至关重要。Django 为 templates/views 提供了 Paginator 类，DRF 为 API 提供了内置分页功能。
# ❌ loading everything — slow, memory-heavy, bad UX with thousands of rows
articles = Article.objects.all() # could be 100,000 records
from django.core.paginator import Paginator
def article_list(request):
articles = Article.objects.all().order_by("-created_at") # ORDER matters for consistent pages
paginator = Paginator(articles, 20) # 20 items per page
page_number = request.GET.get("page") # ?page=2
page_obj = paginator.get_page(page_number) # the requested page
return render(request, "list.html", {"page_obj": page_obj})
<!-- in the template -->
{% for article in page_obj %}
<h2>{{ article.title }}</h2>
{% endfor %}
{% if page_obj.has_previous %}<a href="?page={{ page_obj.previous_page_number }}">Prev</a>{% endif %}
Page {{ page_obj.number }} of {{ page_obj.paginator.num_pages }}
{% if page_obj.has_next %}<a href="?page={{ page_obj.next_page_number }}">Next</a>{% endif %}
Paginator 将查询集分成多页，get_page() 返回一个页面对象，其中包含导航帮助器（has_next、next_page_number 等）— 请注意它向查询添加了 LIMIT/OFFSET，因此只从数据库中获取一页。
# global default in settings.py
REST_FRAMEWORK = {
"DEFAULT_PAGINATION_CLASS": "rest_framework.pagination.PageNumberPagination",
"PAGE_SIZE": 20,
}
# now list endpoints are automatically paginated, returning:
# { "count": 1000, "next": "...?page=3", "previous": "...?page=1", "results": [...] }
DRF 在配置后自动对列表端点进行分页，返回页面元数据（count、next/previous 链接）以及结果 — 客户端通过提供的 URL 导航。
PageNumberPagination → ?page=2 (simple page numbers)
LimitOffsetPagination → ?limit=20&offset=40 (flexible offsets)
CursorPagination → opaque cursor; consistent & performant for large/changing data
(avoids OFFSET performance issues on huge datasets)
⚠️ OFFSET-based pagination (page/offset) gets SLOWER on deep pages of huge tables
(the DB must skip OFFSET rows). For very large datasets, CURSOR pagination
(keyset, using a WHERE on an indexed column) is far more efficient.
⚠️ Always ORDER BY a stable field, or pages can be inconsistent/repeat items.
分页对于构建可处理真实数据量的高性能、可用性强的应用程序至关重要 — 没有它，列表端点和加载整个表（可能包含数千或数百万行）的页面会变得缓慢、内存密集且无法使用，既对数据库造成压力，又使用户和客户端感到困扰。
理解分页是日常实践知识：Django 的 Paginator 处理传统 views/templates（将查询集分成具有导航帮助器的页面，通过 LIMIT/OFFSET 高效地仅获取一页），而 DRF 的 内置分页 处理 API（在配置后自动对列表端点进行分页，包括元数据和导航链接）— 两者都需要，取决于您是构建服务器呈现的页面还是 API。
知道如何在两种情况下实现分页对于几乎任何数据列表功能都是必要的。
性能要点 特别是有价值的高级知识：标准的基于 OFFSET 的分页在非常大表的深层页面上性能下降（数据库必须跳过所有前面的行），因此 游标（keyset）分页 是大型或快速变化数据集的高效选择，并且总是需要 按稳定字段排序 来避免页面之间出现不一致或重复的结果。
理解基本机制（Paginator、DRF 分页类）和这些性能考虑因素（OFFSET 与游标分页、一致的排序）对于构建随着数据增长而保持快速和正确的应用程序都很重要 — 分页是无处不在的需求，尤其是大规模实现，这是一项直接影响应用性能和用户体验的实用技能。