ThinkPHP分页需手动渲染以适配CSS框架：禁用render()，用items()和分页方法获取数据，手写HTML结构并保留URL参数，大数据量时做页码截断。
ThinkPHP 的分页默认渲染 HTML 结构固定、样式难改，直接调用 render() 会输出带 <ul> 和 class="pagination" 的标签，但项目里往往要嵌入现有 CSS 框架（如 Tailwind、Bootstrap 5）或自定义 DOM 结构——这时候不能靠改 CSS 覆盖，得从源头控制输出内容。
用 render() 之前先关掉默认模板
ThinkPHP 6 默认使用内置模板渲染分页 HTML，哪怕你只改一个 <li> 的 class，也得重写整个模板。最直接的办法是禁用它，改用纯数据驱动渲染：
- 在分页对象生成后，调用
simple()或保持paginate()，但**不要立即调用render()** - 改用
$page->items()拿数据列表，$page->currentPage()、$page->lastPage()、$page->hasPreviousPage()、$page->hasNextPage()等方法手动拼结构 - 关键点：
$page->render()一旦调用，就会触发模板渲染并输出缓存，后续再取数据可能不一致
手写分页 HTML：兼容 Bootstrap 5 的常见结构
Bootstrap 5 分页要求 <nav> 包裹 <ul class="pagination">，每页是 <li class="page-item">，链接在 <a class="page-link"> 里。注意：当前页要用 disabled + active 双状态，且不能是链接。
<nav>
<ul class="pagination">
<li class="page-item<?php echo $page->onFirstPage() ? ' disabled' : ''; ?>">
<a class="page-link" href="?page=1">首页</a>
</li>
<?php for ($i = 1; $i <= $page->lastPage(); $i++): ?>
<li class="page-item<?php echo $i == $page->currentPage() ? ' active' : ''; ?>">
<a class="page-link" href="?page=<?php echo $i; ?>"><?php echo $i; ?></a>
</li>
<?php endfor; ?>
<li class="page-item<?php echo $page->onLastPage() ? ' disabled' : ''; ?>">
<a class="page-link" href="?page=<?php echo $page->lastPage(); ?>">尾页</a>
</li>
</ul>
</nav>⚠️ 容易漏的点：$page->onFirstPage() 和 $page->onLastPage() 才是判断首页/尾页是否禁用的正确方法，别用 currentPage() === 1 这类硬比较——当分页参数名不是 page 时（比如用了 pn），onFirstPage() 仍能正确识别，硬比较会失效。
立即学习“PHP免费学习笔记（深入）”；
URL 参数保留：避免分页跳转丢掉搜索条件
真实场景中，分页常和搜索共存（比如 ?keyword=abc&status=1&page=2）。直接拼 ?page=3 会清空其他参数。
- 用
$request = \think\facade\Request::param();拿全部 GET 参数 - unset 掉分页键（默认是
page，但可通过->appends(['page' => 'pn'])改） - 构造新 URL：用
url('index/list', array_merge($request, ['page' => $i]))（如果用路由）；或手动拼http_build_query() - 注意：ThinkPHP 的
url()函数对 appends 支持有限，简单场景推荐http_build_query(array_merge($_GET, ['page' => $i]))更可控
性能与边界：大数据量下别真循环所有页码
当总页数达到 500+，for ($i = 1; $i lastPage(); $i++) 会生成巨长 HTML，卡浏览器，也暴露总数据量。实际产品中应该做「省略号截断」：
- 显示当前页前后各 2 页，加首尾，中间用
<li class="page-item disabled"><span class="page-link">...</span></li> - 计算逻辑示例：
$start = max(1, $currentPage - 2); $end = min($lastPage, $currentPage + 2); - 然后分别处理：首页、$start 前的省略号、$start 到 $end、$end 后的省略号、尾页
- 别忘了
$lastPage可能小于 5，此时不显示省略号——这个边界检查很容易被跳过
真正麻烦的从来不是写几行 HTML，而是把「当前页高亮」「禁用状态」「参数透传」「页码截断」这四件事同时做对，而且不耦合到具体 CSS 框架。每次换 UI 库，只需要动 HTML 标签和 class，逻辑层完全不动。
