直接修改模板字符串最省事，按钮文字硬编码在模板中；appends()自动编码需避免重复；simplepaginate()需构造函数传prev/next参数；自定义分页类须重写按钮方法并注意路由变量。
直接改模板里的文字字符串最省事
ThinkPHP 的 render() 方法最终输出的 HTML 是由模板文件生成的，按钮文字（比如“上一页”“下一页”）就硬写在模板里，不是从语言包或配置项动态读取的。你不需要动任何类、不需重写方法，只要找到对应模板，把字符串替换成想要的就行。
常见错误是去翻 Bootstrap.php 源码试图改 getPreviousButton() 里的默认参数——它只是 fallback，真正起作用的是模板里那几行 echo 或占位符。
- 模板路径一般在
thinkphp/library/think/pagination/bootstrap.php（TP6）或vendor/topthink/framework/src/view/paginate.tpl（TP5.1） - 复制一份到你的项目视图目录，例如
resources/view/paginate/custom.php - 在模板里搜
"上一页"、"下一页"，替换成"←"、"→"或带图标的 HTML：<i class="icon-left"></i> 前一页 - 调用时指定模板：
$list->render('custom')，注意不带.php后缀
用 appends() 传参时中文乱码怎么避免
分页链接里带中文参数（如 ?tab=订单）本身没问题，但 URL 编码和解码环节一漏，就会出现 %E8%AE%B7%E5%8D%95 这种乱码，甚至导致 404 —— 因为服务端没正确还原原始值。
ThinkPHP 的 appends() 默认会对值做 urlencode()，所以你传进去的已经是编码后的，但如果你手动拼 URL 或在 JS 里读取，就得自己处理。
- 控制器里用
request()->except(['page'])获取其他参数，它返回的是原始值，appends()内部会自动编码 - 别自己拼
?tab=<?php echo urlencode($tab); ?>，重复编码会导致双层 %，比如%25E8%25AE%25B7 - 前端 JS 读 URL 参数时，必须用
decodeURIComponent()，不能只靠URLSearchParams默认行为 - 如果参数来自 POST 表单，先在控制器里
urldecode()再传给appends()，否则可能被二次编码
自定义分页类里改按钮逻辑要重写 getPreviousButton() 和 getNextButton()
当你需要更复杂的控制——比如首页/末页按钮只在页数 ≥ 5 时显示，或者当前页为 1 时不渲染“上一页”标签（而非仅禁用），就必须继承 think\Paginator 并重写按钮方法。光改模板只能换文字，不能删结构。
TP6 中，Bootstrap 驱动的按钮方法是 protected 的，你继承后可以覆盖，但要注意：它内部调用的 url() 和 getDisabledTextWrapper() 是父类方法，别漏掉。
- 类必须放在能被自动加载的位置，比如
app/paginator/driver/CustomPager.php，命名空间为app\paginator\driver - 配置中设
'type' => 'CustomPager'，TP 会自动实例化 - 重写
getPreviousButton()时，判断$this->currentPage() === 1就直接 return 空字符串，而不是调用getDisabledTextWrapper() - 图标建议用 CSS 类（如
fa-chevron-left）而非内联 SVG，方便统一维护样式 - 别在按钮方法里硬写 HTML 标签结构，保持与父类一致的 wrapper 逻辑，否则可能破坏 JS 绑定或无障碍支持
simplePaginate() 下按钮文字改不了？那是你没传对参数位置
simplePaginate() 不走完整分页流程，它跳过总数统计、页码范围计算，只生成上一页/下一页两个链接。它的按钮文案不从模板来，也不受 setConfig() 影响，而是由构造函数参数决定 —— 但这个参数必须在调用时显式传入，不能靠链式配置。
常见错误是写成 $list->simple()->setConfig('prev', '向前')，这完全无效，因为 simple() 返回的是简化对象，setConfig() 已无意义。
- 正确写法：
UserModel::simplePaginate(15, ['prev' => '←', 'next' => '→']) - 注意：第二个参数是数组，且键名固定为
prev/next，不是previous或previous_button - 该模式下没有
first/last按钮，所以配了也无效 - 如果你需要首尾按钮 + 简化逻辑，只能自己手写两链接，别依赖
simplePaginate()
真正容易被忽略的点是：自定义类里的 url() 方法返回的链接，是否包含所有路由变量（比如 id 或 category_slug）。默认只保留 query 参数，路由参数得手动塞进 appends() 或重写 url() 逻辑 —— 否则点开就是 404。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
