ThinkPHP 8.0分页需同步解决性能、样式与参数保持问题：启用simple模式跳过COUNT(*)、用query参数保留搜索条件、自定义模板适配UI、通过var_page适配API参数名。

在ThinkPHP 8.0中实现分页时，既要让后端查询不拖慢接口响应，又要让前端按钮样式贴合项目UI、不和Element Plus或Tailwind冲突，还得保证搜索条件翻页后不丢失——这些需求必须同步解决，不能只调一个paginate(15)就完事。

避开COUNT(*)卡顿：启用simple模式

第一步：在控制器中调用paginate时显式开启simple模式
→ UserModel::where('status', 1)->order('id desc')->paginate(['list_rows' => 20, 'simple' => true]);

第二步：模板中必须改用{$list->render()}渲染，不能继续用{$list->show()}——【simple模式下show()会报错】

第三步：判断是否有下一页，用$list->hasMore()代替$list->lastPage()；【lastPage()在simple模式下返回null，直接调用会导致模板崩溃】

立即学习“PHP免费学习笔记（深入）”；

这一步操作起来很简单，但跳过COUNT(*)后，分页器不再显示“共XX条”和末页按钮，只保留上一页/下一页和当前页码。如果业务强依赖总条数，需手动缓存总数并传参，否则不要硬查。

保留搜索参数：query参数精准注入

方法一：用request()->except过滤page类参数
→ UserModel::paginate(['list_rows' => 15, 'query' => request()->except(['page', 'page_no'])]);

方法二：按字段白名单取参（推荐用于表单筛选）
→ UserModel::paginate(['list_rows' => 15, 'query' => input('only', ['keyword', 'category_id', 'start_time', 'end_time'])]);

前端设计优化skill

前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。

下载

注意：别用request()->only(['keyword'])，字段为空时会拼出?keyword=这种脏URL，前端可能误判为有效搜索条件。

自定义分页模板：复制+修改+引用

找到框架内置模板路径thinkphp/library/think/pagination/bootstrap.php，复制到resources/view/paginate/custom.php。

打开custom.php，删掉所有Bootstrap类名，替换成你项目里已有的CSS类，比如把改成，把

改成
。

关键点：保留所有{$page}变量和逻辑分支，尤其是{volist name="pages" id="vo"}和{eq name="vo" value="$current"}，这些是分页器功能的骨架，改错一个就会漏页或跳转失效。

最后在控制器中指定模板：
→ UserModel::paginate(['list_rows' => 15, 'type' => 'paginate/custom']);

适配API接口：var_page重定向分页参数名

当你的前端请求带的是page_no而非page时，必须显式声明参数映射：
→ UserModel::paginate(['list_rows' => 10, 'var_page' => 'page_no']);

这一步不能省，【数字参数形式如paginate(10)永远只认page，不会自动识别page_no】，否则无论前端传多少page_no，后端始终返回第1页数据。

配合query参数一起用，就能同时满足：参数名自定义 + 搜索条件不丢失 + simple性能优化。