ThinkPHP的render()方法默认输出Bootstrap风格的HTML结构，包含及嵌套的和标签，class名如active、disabled等硬编码固定，不兼容Tailwind等工具类框架，且结构不可控、易受版本升级影响。
ThinkPHP 的 render() 方法输出的是什么结构
ThinkPHP 分页的 render() 默认输出带 <ul><li></ul> 的 HTML，但 class 名是固定的（如 pagination、active、disabled），不带 Tailwind 类名。你不能直接套用 Tailwind 工具类，因为它的结构不可控，且部分 class 会和 Tailwind 冲突（比如 disabled 可能被 CSS 重置）。
真正可行的方式是：**禁用默认渲染，手动遍历分页数据，用 Tailwind 控制每一项样式**。
- 调用
$list->render()前，先用$list->appends(request()->except('page'))保留查询参数 - 改用
$list->currentPage()、$list->lastPage()、$list->hasPages()、$list->onFirstPage()、$list->onLastPage()等方法取状态 - 用
$list->getUrl($page)生成每页链接（自动处理 base path 和 query） - 避免直接拼接 URL，否则会丢掉路由前缀或参数
如何手写 Tailwind 分页导航（含上一页/下一页/省略号）
ThinkPHP 的分页对象（LengthAwarePaginator）本身不提供「中间页码范围」方法，得自己算。常见做法是显示当前页 ±2 页，前后加省略号。
示例 Blade 模板片段：
立即学习“PHP免费学习笔记（深入）”；
<div class="flex items-center justify-between border-t border-gray-200 px-4 py-3 sm:px-6">
<div class="flex-1 flex justify-between sm:hidden">
@if ($list->onFirstPage())
<span class="relative inline-flex items-center px-4 py-2 text-sm font-medium text-gray-500 bg-white border border-gray-300 cursor-not-allowed rounded-md">上一页</span>
@else
<a href="{{ $list->previousPageUrl() }}" class="relative inline-flex items-center px-4 py-2 text-sm font-medium text-blue-600 bg-white border border-gray-300 rounded-md hover:bg-gray-50">上一页</a>
@endif
@if ($list->onLastPage())
<span class="relative inline-flex items-center px-4 py-2 text-sm font-medium text-gray-500 bg-white border border-gray-300 cursor-not-allowed rounded-md">下一页</span>
@else
<a href="{{ $list->nextPageUrl() }}" class="relative inline-flex items-center px-4 py-2 text-sm font-medium text-blue-600 bg-white border border-gray-300 rounded-md hover:bg-gray-50">下一页</a>
@endif
</div>
<p><div class="hidden sm:flex-1 sm:flex sm:items-center sm:justify-between">
<div>
<p class="text-sm text-gray-700">
共 <span class="font-medium">{{ $list->total() }}</span> 条，第 <span class="font-medium">{{ $list->currentPage() }}</span> 页 / 共 <span class="font-medium">{{ $list->lastPage() }}</span> 页
</p>
</div>
<div>
<nav class="relative z-0 inline-flex rounded-md shadow-sm -space-x-px" aria-label="Pagination">
<!-- 上一页 -->
@if ($list->onFirstPage())
<span class="relative inline-flex items-center px-2 py-2 text-sm font-medium text-gray-500 bg-white border border-gray-300 cursor-not-allowed rounded-l-md">
«
</span>
@else
<a href="{{ $list->previousPageUrl() }}" class="relative inline-flex items-center px-2 py-2 text-sm font-medium text-gray-500 bg-white border border-gray-300 rounded-l-md hover:bg-gray-50">
«
</a>
@endif</p><pre class="brush:php;toolbar:false;"> <!-- 页码列表 -->
@foreach (range(1, $list->lastPage()) as $i)
@if ($i == 1 || $i == $list->lastPage() || ($i >= $list->currentPage() - 2 && $i <= $list->currentPage() + 2))
@if ($list->currentPage() == $i)
<span class="z-10 bg-blue-500 border-blue-500 text-white relative inline-flex items-center px-4 py-2 text-sm font-medium border rounded-md">{{ $i }}</span>
@else
<a href="{{ $list->url($i) }}" class="bg-white border-gray-300 text-gray-500 hover:bg-gray-50 relative inline-flex items-center px-4 py-2 text-sm font-medium border rounded-md">{{ $i }}</a>
@endif
@elseif ($i == $list->currentPage() - 3 || $i == $list->currentPage() + 3)
<span class="relative inline-flex items-center px-4 py-2 text-sm font-medium text-gray-500 bg-white border border-gray-300">…</span>
@endif
@endforeach
<!-- 下一页 -->
@if ($list->onLastPage())
<span class="relative inline-flex items-center px-2 py-2 text-sm font-medium text-gray-500 bg-white border border-gray-300 cursor-not-allowed rounded-r-md">
»
</span>
@else
<a href="{{ $list->nextPageUrl() }}" class="relative inline-flex items-center px-2 py-2 text-sm font-medium text-gray-500 bg-white border border-gray-300 rounded-r-md hover:bg-gray-50">
»
</a>
@endif
</nav>
</div>
为什么不能用 render() + Tailwind CSS 覆盖样式
有人试过给 render() 输出的 <ul class="pagination"></ul> 加 Tailwind 类，再用 CSS 覆盖默认样式，结果发现：Tailwind 的 text-gray-500 等工具类会被 ThinkPHP 自带的 CSS 或框架全局样式覆盖，尤其是 !important 冲突、伪类（:hover）失效、disabled 状态无法响应。
- ThinkPHP 默认加载的
pagination.css（如果启用）会设置.pagination .disabled为pointer-events: none，而 Tailwind 的cursor-not-allowed不生效 -
render()输出的<a></a>标签没有aria-current="page"，对无障碍支持不友好；手写可主动加 - 移动端响应式需要
sm:hidden/sm:flex切换布局，而render()输出的 HTML 结构固定，没法插 slot 或条件 class - 一旦升级 ThinkPHP 版本，
render()的 HTML 结构可能微调（比如 v6.0 → v6.3 改了<span></span>嵌套），导致样式大面积崩坏
额外注意：URL 参数丢失和 SEO 友好性
手写分页时最容易漏掉的是请求参数透传。例如搜索关键词 ?keyword=abc、分类 ?category=2，翻页后必须带上，否则用户一翻页就回到全部数据。
- 务必在控制器中用
$list = $query->paginate(10)->appends(request()->except('page')) - 不要用
request()->all()，否则会把page也 append 两次，导致 URL 出现page=2&page=2 -
$list->url($i)内部已自动合并 appends 的参数，比手动拼url('list?page='.$i.'...')更可靠 - 如果用了路由模型绑定或资源路由，
$list->url()仍能正确生成带/admin/users/前缀的链接，前提是你的路由定义没写死
复杂点在于多级嵌套参数（比如 ?filter[status]=active&filter[type]=vip），appends() 能处理数组形式，但需确保前端提交方式一致；否则后端要先 array_merge_recursive 再传入。
