ThinkPHP分页必须配合SQL排序，ORDER BY需在paginate()前执行且字段须建索引；前端需同步传递并校验sort/order参数；模板中应直接使用$list->render()等原生方法。
ThinkPHP 中排序和分页必须配合使用，否则分页结果会乱序、重复或跳数据。核心原则是：排序必须由 SQL 的 ORDER BY 完成，且必须在分页执行前确定；分页逻辑（如 paginate()）依赖这个稳定顺序才能准确定位每一页。
一、控制器里先写好 ORDER BY，再调用 paginate()
分页不是“先查再排”，而是“先排再分”。漏掉 order() 是导致翻页错乱的最常见原因。
- ✅ 正确写法：明确指定排序字段和方向，例如按创建时间倒序
UserModel::where('status', 1)->order('create_time desc')->paginate(10)
- ✅ 多字段排序也支持，比如先按状态升序、再按 ID 降序（适合状态相同的数据稳定排列）
UserModel::where('status', 1)->order('status asc, id desc')->paginate(10)
立即学习“PHP免费学习笔记（深入）”；
- ❌ 错误写法：没写
order()，数据库返回顺序不确定，第 2 页可能包含第 1 页已出现过的记录 - ❌ 错误写法：把排序放在
paginate()后面，比如->paginate(10)->order(...)—— 此时查询已执行，order 失效
二、前端传参要同步保留排序条件
用户点“按标题升序”后翻到第 3 页，链接里必须同时带 sort=title&order=asc&page=3，否则下一页仍按默认规则查。
- 在控制器中解析并校验排序参数，避免注入风险
$allowed = ['id', 'title', 'create_time', 'score'];
$sort = input('sort/s', 'id');
$order = in_array($sort, $allowed) ? input('order/s', 'desc') : 'desc';
$list = UserModel::where('status', 1)
->order($sort . ' ' . $order)
->paginate(10, false, ['query' => ['sort' => $sort, 'order' => $order]]);
-
['query' => [...]]确保生成的分页 HTML 链接自动带上当前 sort 和 order - 模板中渲染分页时，
{$list->render()}就能正确拼接所有参数，无需手动拼 URL
三、数据库索引必须匹配排序字段
没有索引的 ORDER BY 会导致每次分页都全表扫描，尤其数据量大时，第 100 页可能卡住几秒。
- 单字段排序（如
ORDER BY create_time DESC）：给create_time加普通索引 - 多字段排序（如
ORDER BY status ASC, id DESC）：建联合索引(status, id)，顺序不能颠倒 - 游标分页（
cursorPaginate()）更依赖索引：必须确保排序字段非 NULL、严格单调、有索引，否则游标定位失败
四、模板里安全输出，不破坏分页对象
分页对象 $list 是一个完整实例，含数据、总数、当前页、渲染方法等。一旦转成数组或 JSON，就再也调不出分页 HTML。
- ✅ 循环数据：
{volist name="list" id="item"}{$item.title}{/volist} - ✅ 输出分页条：
{$list->render()}（不是{$list->show()}，也不是{$list|raw}） - ✅ 获取总数：
{$list->total()}（不是count($list)，那只是当前页条数） - ❌ 别写
{$list->toArray()}或json_encode($list)再 render —— 这会报错或静默失败
