thinkphp 的 render() 方法可通过传参（如 theme、var_page、current_class 等）动态控制分页 html 结构，无需修改模板文件；需注意 query 参数透传、模板路径规范及 ul 默认样式导致的响应式陷阱。
render() 传参控制 HTML 结构，无需改模板文件
ThinkPHP 的 render() 方法本身支持运行时传入配置数组，直接覆盖默认 HTML 拼接逻辑，不用复制、修改任何 tpl 或 php 模板文件。关键不是“换模板”，而是用好占位符和参数组合。
常见错误是以为必须改 bootstrap4.php 才能动结构——其实多数响应式需求（比如去掉 <ul></ul>、改成 <nav></nav>、加 aria-label）靠传参就能搞定。
-
theme是核心：例如'theme' => '<nav aria-label="Pagination">%UP_PAGE%%LINKS%%DOWN_PAGE%</nav>'，所有占位符如%UP_PAGE%、%LINKS%、%NOW_PAGE%都会被自动替换 -
var_page必须设对：如果 URL 用?p=2而非默认?page=2，不配'var_page' => 'p'，点击页码后参数名错乱，翻页失效 -
current_class和prev_text/next_text可分别控制当前页样式和文字，比如'prev_text' => '<span aria-hidden="true">«</span>'，方便无障碍适配
自定义分页模板文件的正确路径与加载方式
真要彻底重写 HTML（比如加跳转输入框、GO 按钮、总数提示），就得换模板文件。但 ThinkPHP 不读你随便放的文件，必须走标准注册流程。
错误做法：把 bootstrap4.php 复制到 view/paginate/ 下，然后在模板里写 {$list->render('paginate/custom')}——这不会生效，因为框架根本不识别这个路径。
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- 模板文件必须放在
app/template/paginate/（注意是app/下，不是view/） - 文件名任意，比如
simple.php，但内容必须返回字符串，且不能有输出（不能 echo，不能带空格或 BOM） - 在
config/paginate.php中显式声明：'type' => 'Simple'，并补全'drivers' => ['Simple' => \app\template\paginate\Simple::class] - 类
Simple必须实现think\contract\PaginatorRenderInterface，否则启动时报Class not found
响应式分页必须处理的 query 参数透传问题
前端做响应式分页（比如小屏只显示上一页/下一页+跳转框），后端生成的链接若丢掉搜索条件，?page=2 一发过去就变成全量数据。这不是样式问题，是功能断裂点。
很多人只记得在 paginate() 里传 ['query' => request()->param()]，却忽略两点：
- POST 或 JSON 请求中的筛选字段（如
{ "keyword": "test", "status": 1 }）不会进request()->param()，得手动提取并合并：array_merge(request()->param(), input('post.')) - 敏感参数（如
token、sign）不能无脑透传，要用白名单过滤：array_intersect_key(request()->param(), array_flip(['keyword', 'status', 'sort'])) - 带变量路由（如
/user/:id）必须用appends(['id' => $id])显式追加，否则render()生成的链接缺路由变量，404
移动端分页常见 DOM 结构陷阱
响应式布局常把分页塞进 <div class="pagination"> 再用 flex 布局，但 ThinkPHP 默认输出的是 <code><ul class="pagination"></ul>。直接套 CSS 很容易崩——因为 ul 有默认 margin/padding，li 有 list-style，flex 子项行为也和 div 不同。
最省事又可控的方式是用 theme 把外层干掉，再用内联样式或 class 控制语义化结构：
render([
'theme' => '<nav class="pagination-nav"><div class="pagination-inner">%UP_PAGE%%LINKS%%DOWN_PAGE%</div></nav>',
'current_class' => 'pagination-link is-current',
'prev_text' => '<span class="pagination-ctrl">‹</span>',
'next_text' => '<span class="pagination-ctrl">›</span>'
])
这样你可以完全用 CSS 控制 .pagination-inner 的 flex-wrap、gap、justify-content，而不用 hack ul/li 的原生样式。别小看这个细节：很多“响应式分页在 iOS 上错位”的问题，根源就是没清掉 ul 的默认样式。
