ThinkPHP分页模板替换需显式调用$list->render('template_path')并确保模板位于视图目录，如view/paginators/bootstrap5.html，模板中使用$page、$lastPage等变量及{:url()}生成带参数链接，同时保留active、disabled等关键class以保障状态样式生效。
ThinkPHP 分页模板怎么替换默认 HTML？
ThinkPHP 默认分页输出的 HTML 结构固定，class 名是 pagination，里面一堆 <li> 和 <a>，直接套 Bootstrap 或自定义 UI 会错位或样式失效。根本原因不是“不能改”，而是没指定模板路径或没覆盖默认渲染逻辑。
ThinkPHP 6.x 起用 render() 方法接管输出，必须显式传入自定义模板路径，否则无论你怎么改配置都走默认模板。
- 确保分页对象调用的是
$list->render()，而不是直接 echo$list（后者会忽略模板） - 模板文件路径必须是视图目录下的相对路径，例如
'paginators/bootstrap5'对应view/paginators/bootstrap5.html - 模板里可用变量：
$page（当前页）、$total（总数）、$lastPage（总页数）、$hasPrev/$hasNext等布尔值 - 不要在模板里写 PHP 逻辑，只用 ThinkPHP 模板语法：
{:url('index', ['page' => $i])}生成链接
如何让分页链接带查询参数（比如搜索关键词）？
默认分页链接只保留 page 参数，其他如 ?keyword=abc&type=1 全丢掉，用户翻页后搜索失效。这不是 bug，是设计如此——需要手动合并当前请求参数。
最稳妥的做法是在控制器中构造分页时传入 query 选项：
立即学习“PHP免费学习笔记（深入）”；
<?php
// 控制器中
$keyword = $this->request->param('keyword', '');
$type = $this->request->param('type', '');
$list = Db::name('article')->where('title', 'like', "%{$keyword}%")
->where('type', $type)
->paginate([
'query' => ['keyword' => $keyword, 'type' => $type],
'page' => $this->request->param('page', 1),
]);
$this->assign('list', $list);
?>
-
query数组里的键值会自动拼进每一页的 URL，不需要手写url()函数拼接 - 如果参数是数组（如
category[]=1&category[]=2），需用http_build_query()处理后再传，不然会被转成字符串 - 注意：不要在模板里用
$Request.param()动态取，因为分页链接生成时上下文已切换，容易漏参或报错
自定义分页样式时 class 冲突怎么办？
你写了 <nav class="my-pagination">，但 CSS 不生效，大概率是框架自带的 pagination class 样式权重更高，或者你漏掉了关键状态类（如 active、disabled）。
- ThinkPHP 分页模板里，当前页项有
class="active"，上一页/下一页不可用时是class="disabled"，必须保留这些 class 才能正确响应状态 - 避免用
!important强行覆盖，优先用更具体的 selector，比如.my-pagination .active > a - 如果用了前端框架（如 Element Plus），它的分页组件不兼容 ThinkPHP 的服务端分页结构，别硬套——要么改模板适配，要么改用纯前端分页（此时需关掉服务端
paginate，改用limit+count）
为什么分页跳转后页面顶部没滚动到列表位置？
这是前端行为，和 ThinkPHP 无关，但常被误认为“分页有问题”。点击页码后浏览器默认跳转到页面顶部，而你的列表可能在中间位置。
- 简单解法：给列表容器加 id，比如
<div id="article-list">，然后在分页链接里加锚点：<a href="{:url('index', ['page' => $i])}#article-list"> - 如果用了 pjax 或 AJAX 分页，需手动调用
scrollIntoView()，例如document.getElementById('article-list').scrollIntoView({ behavior: 'smooth' }) - 注意：锚点仅对完整页面跳转有效；AJAX 刷新时不会触发浏览器原生锚点滚动，必须代码控制
真正麻烦的不是样式怎么写，而是哪些参数要透传、哪些 class 不能删、哪些滚动行为得自己补——这些细节不处理，UI 再漂亮也卡在第一屏动不了。
