Laravel分页核心是paginate()，自动处理查询与偏移，返回LengthAwarePaginator；simplePaginate()跳过COUNT提升性能；可自定义视图、URL参数名及分页器配置。
怎么用 paginate() 实现基础分页
Laravel 的分页核心就是 paginate()，它自动处理查询、偏移计算和分页器实例构建。直接在 Eloquent 查询后调用就行，不需要手动算 offset 和 limit。
常见错误是拿 get() + 手动切数组来“模拟”分页——这会把全量数据查出来，内存爆掉，且丢失分页元信息（如总页数、当前页链接）。
-
paginate()默认每页 15 条，传参可改：paginate(20) - 它返回的是
LengthAwarePaginator实例，带links()、currentPage()、lastPage()等方法 - 注意：不能在已执行
get()或toArray()的集合上调用paginate()，会报错Call to undefined method Illuminate\Support\Collection::paginate() - 如果查询里用了
groupBy或复杂select，可能触发 MySQL 的SQL_CALC_FOUND_ROWS兼容问题，建议显式用simplePaginate()（无总条数）或加withCount()替代
如何替换默认的 Bootstrap 分页视图
Laravel 默认渲染的是 Bootstrap 4/5 风格的 HTML，但项目用 Tailwind、Semantic UI 或纯自定义结构时，直接改样式类没用——因为整个 HTML 结构由 Blade 视图控制。
真正要改的是分页器使用的视图文件，不是 CSS。
- 运行
php artisan vendor:publish --tag=laravel-pagination，会把分页视图复制到resources/views/vendor/pagination - 修改
bootstrap-5.blade.php（或对应名称）里的 HTML 结构和 class，比如把page-link换成px-3 py-1 rounded - 如果想全局换一套，就在
AppServiceProvider::boot()里调用Paginator::defaultView('pagination.custom')，然后新建resources/views/pagination/custom.blade.php - 别在 CSS 里强行覆盖
.pagination .page-link——当分页器没数据时，render()根本不输出 HTML，样式再好看也没用
为什么 simplePaginate() 有时比 paginate() 更快
simplePaginate() 不统计总数，只查「当前页 + 下一页」所需的数据，所以跳过 COUNT(*) 查询。对大表或复杂 JOIN，这个 COUNT 往往是性能瓶颈。
典型场景：评论列表、日志流、实时 feed——用户根本不在意“总共 12847 页”，只关心能不能翻到下一页。
-
simplePaginate()返回的是SimplePaginator，没有lastPage()、total()，links()只显示「上一页 / 下一页」，不显示页码数字 - 不能用
appends()传递参数？可以，用法一样：$comments->appends(['sort' => 'newest'])->links() - 注意：
simplePaginate()的 URL 参数名仍是page，但不会校验页码是否超出范围——第 9999 页请求只会返回空集合，不报错也不重定向 - 如果前端需要“总条数”做滚动加载提示，别硬凑
paginate()，考虑缓存一个近似值，或用withCount()配合主模型查总数
自定义分页 URL 参数名（比如不用 page）
默认所有分页链接都带 ?page=2，但有些 API 要求用 ?cursor=xxx 或 ?offset=20，或者多分页区域共存（如侧边栏标签页 + 主内容区）时需隔离参数名。
关键点：不是改路由，而是改分页器生成链接时用的键名。
- 在查询后链式调用
appends()前，先用withPath()和withQueryString()控制基础 URL，再用setPageName('cursor')改参数名 - 示例：
Article::where('status', 1)->latest()->paginate(10)->setPageName('cursor')，之后links()生成的就是?cursor=2 - 如果同时有多个分页器，必须给每个设不同
pageName，否则点击一个会干扰另一个的页码状态 - 注意：控制器里接收参数时，也要用
request()->input('cursor', 1)，不能再写死request()->page
分页看着简单，但跨请求保持状态、URL 参数污染、大结果集的 COUNT 开销、视图与数据结构的耦合——这些地方一松劲就出线上问题。尤其是 appends() 传了对象或数组却没 toString()，很容易让链接里塞进一串乱码。
