tp6分页样式彻底修改必须替换驱动类，因html结构由bootstrap等驱动硬编码生成；仅改css或模板无法变更标签，需新建实现paginatorrenderinterface的驱动并配置启用。
ThinkPHP 分页样式不能靠改 CSS 或模板文件就彻底搞定，核心得看用的是哪个版本、走的是哪条渲染路径——TP5.1/6 的分页 HTML 结构由驱动类硬编码生成，不换驱动，render() 传参或改模板最多动文字，动不了 <ul></ul>、<nav></nav> 这些标签。
TP6 必须替换分页驱动才能改 HTML 标签结构
TP6 的 Paginator 默认使用 think\pagination\driver\Bootstrap，它的 render() 方法直接拼出带 <nav><ul><li></ul></nav> 的完整 HTML。你改 template 配置或继承重写 render() 都无效，因为底层驱动没换，视图层根本收不到你自定义的结构。
必须做两件事：
- 新建驱动类，实现
think\contract\PaginatorRenderInterface接口，重写render()方法返回纯 HTML 字符串 - 在
config/paginate.php中配置：'driver' => 'custom'，并映射：'drivers' => ['custom' => \app\common\Paginator\CustomDriver::class] - 类文件路径要能被自动加载，命名空间与目录严格匹配，比如放在
app/common/Paginator/CustomDriver.php，命名空间就得是app\common\Paginator
TP5.1/TP6 都支持运行时传参控制 render() 文字和占位符
如果只是想改“上一页”文字、页码范围、当前页 class 名，不用动驱动，render() 方法本身支持数组参数覆盖默认行为。
-
prev_text和next_text：例如$list->render(['prev_text' => '‹', 'next_text' => '›']) -
theme：用占位符拼结构，如'%UP_PAGE%%NOW_PAGE%/%LAST_PAGE%%DOWN_PAGE%'，可用占位符包括%FIRST%、%LINKS%、%TOTAL%等 -
current_class：设成'active'或'is-current'，方便 CSS 定位当前页链接 -
var_page：URL 参数名不一致时必须设，比如链接是?p=2，就得传['var_page' => 'p']，否则点击后页码不跳
保留查询参数最易漏的三个地方
分页链接丢失搜索条件或路由变量，是自定义样式后最常出现的 404 或数据错乱根源。
- 用
withQuery(input('param.'))透传全部 GET 参数，尤其带关键词搜索的页面 - 对带变量的路由（如
/user/:id），手动追加：->appends(['id' => $id]) - 启用了 URL 后缀（如
.html）时，render()要显式指定 base URL：['url' => url('user/index', [], false, true)]，否则生成的链接会多一层后缀
别踩这些坑：常见错误写法
有些操作看着顺手，实际破坏分页对象完整性，调试时很难定位。
- ❌ 先
select()再调paginate()：报Call to undefined method think\Collection::paginate()，必须链式调用where()->order()->paginate() - ❌ 用
count($list)获取总条数：它只返回当前页数据量；正确方式是$list->total() - ❌ 在模板里依赖
$_paginates这类全局变量：ThinkPHP 不自动注入，控制器必须assign('list', $list)显式传入 - ❌ 直接改
vendor/topthink/think-orm/src/paginator/driver/bootstrap4.php：Composer 更新后立刻被覆盖，白忙一场
真正自由控制分页 HTML，TP6 得换驱动，TP5.1 可以继承重写类，但都绕不开「驱动决定结构，参数只管填充」这个前提。最容易被忽略的是 query 参数透传逻辑——它不随样式改动自动适配，必须每处手动补全。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
