ThinkPHP 6 的 render() 方法可通过传参（如 theme、var_page、current_class）动态控制分页 HTML 结构，无需修改模板文件；也可禁用 render() 后手动遍历分页数据并用 getUrl() 生成链接，全程自定义标签与 Tailwind 类。
ThinkPHP 6 的 render() 方法怎么改分页 HTML 结构
ThinkPHP 6 默认的分页 HTML 是固定模板，想加 class、换标签、插入分割符，不能靠配置项硬改，得重写 render() 返回的 HTML 字符串。核心思路是：获取原始渲染结果 → 用正则或 DOM 解析 → 替换节点结构 → 返回新 HTML。
直接修改 think\paginator\driver\Bootstrap 类不推荐，下次更新可能被覆盖。稳妥做法是在控制器或视图里对 $page->render() 的输出做后处理：
-
render()返回的是完整 HTML 片段（含<ul><li></ul>），不是纯数组，所以不能直接 foreach - 别用
str_replace粗暴替换页码数字，容易误伤其他数字（比如 URL 中的 ID） - 推荐用
preg_replace_callback匹配<li class="page-item">.*?</li>这类块级结构，再逐个处理 - 如果要加「第 X 页」文字或图标（如
<i class="icon-angle-right"></i>），在回调里拼接进去即可
如何让首页/末页显示文字而不是「«」和「»」
默认分页器用的是 Bootstrap 风格的左右箭头符号，但中文项目常需要「首页」「上一页」「下一页」「尾页」。这由 render() 内部调用的 getPreviousButton() 和 getNextButton() 控制，但它们是 protected 方法，无法直接重写。
更可行的方式是：在分页对象生成后、调用 render() 前，手动设置其属性：
立即学习“PHP免费学习笔记（深入）”；
- 通过
$page->withPath('/news')确保链接路径正确，避免分页跳转到根路径 - 用
$page->setPreviousButton('上一页')和$page->setNextButton('下一页')（需确认版本支持；TP6.0.13+ 已开放该方法） - 若版本不支持，可继承
think\paginator\driver\Bootstrap，重写getPreviousButton()，把«换成自定义字符串 - 注意：「首页」「尾页」按钮默认不存在于 Bootstrap 分页器中，得自己在 render 后的 HTML 中用正则补上
<li><a href="...?page=1">首页</a></li>
自定义分页时，URL 参数丢失怎么办
常见现象：列表页带搜索参数 ?category=2&keyword=php，点击页码后只剩 ?page=2，搜索条件全丢了。这是因为分页器默认只保留 page 参数。
解决方式不是改模板，而是改分页对象的生成逻辑：
- 构造分页器时，显式传入当前请求的所有有效参数：
LengthAwarePaginator::make($items, $total, $perPage, $currentPage, ['query' => request()->except('page')]) - 或者用更通用的方式：
$page->appends(request()->except('page'))，在调用render()前链式调用 - 注意
request()->except('page')会过滤掉 page，但保留其他所有 GET 参数，包括空值；如需过滤空值，得手动array_filter(request()->param()) - 如果用了路由变量（如
route('news.index', ['category' => 2])），确保分页器的path()方法返回的是当前路由 URL，而非硬编码路径
为什么自定义样式后，CSS 样式不生效或错位
不是代码没写对，大概率是 CSS 优先级或结构变更导致。ThinkPHP 6 默认分页用的是 Bootstrap 4/5 的 class（如 pagination、page-link），你改了 HTML 结构但没同步更新 CSS 规则，浏览器就找不到对应样式。
排查要点：
- 检查浏览器开发者工具，看最终渲染出的
<nav><ul class="pagination"></ul></nav>是否还存在——如果被你替换成<div class="my-pager">，那原有 <code>.paginationCSS 就完全失效 - 不要依赖框架自带的 Bootstrap CSS，要么重写整套分页 CSS，要么在自定义 HTML 中保留关键 class（例如仍用
class="page-link"） - 移动端适配容易被忽略：原生 Bootstrap 分页有
@media响应式规则，自定义后若删了flex布局或justify-content，小屏下页码会堆成一列或溢出 - JavaScript 绑定也受影响：如果有 JS 监听
.page-link的 click，而你改成.pager-link，事件就失效了
真正麻烦的不是改 HTML，而是改完之后要同步验证所有终端、所有交互、所有参数传递是否还健壮——这些细节一旦漏掉，线上就容易翻车。
