paginate() 返回 LengthAwarePaginator 实例，含分页元信息，需用 items() 取数据、total() 获取总数；withQueryString() 保留查询参数；Blade 中用 links() 渲染并指定样式；simplePaginate() 适用于大数据量且无需总页数的场景。
直接用 paginate() 就能分页，但前端渲染链接时容易漏掉查询参数、样式错乱或跳转后丢失搜索条件。
为什么 paginate() 返回的数据结构和 get() 不一样
paginate() 返回的是 Illuminate\Pagination\LengthAwarePaginator 实例，不是普通集合。它自带分页元信息（如 current_page、last_page、total），也重写了 toArray()，所以不能直接当数组遍历数据。
- 取数据要用
$users->items()或直接遍历$users（底层已实现IteratorAggregate） - 总条数是
$users->total()，不是count() - 当前页码是
$users->currentPage()，不是request()->query('page') - 调用
->toJson()会包含data、links、meta字段，适合 API 场景
如何保留 URL 查询参数（比如搜索关键词、筛选状态）
默认 paginate() 生成的分页链接只保留 page 参数，其他如 ?keyword=laravel&status=active 全部丢失。必须显式合并：
Users::where('status', request('status', 'active'))
->when(request('keyword'), function ($q) {
return $q->where('name', 'like', '%'.request('keyword').'%');
})
->paginate(15)
->withQueryString();
->withQueryString() 会自动把当前请求所有 query 参数带入分页链接；若只需部分参数，用 ->appends(['keyword' => request('keyword')])。
立即学习“前端免费学习笔记（深入）”；
- 注意：不要在
appends()里传敏感字段（如token、password） -
withQueryString()在 Laravel 9+ 支持，在 8.x 需手动appends(request()->except('page')) - 如果用了路由模型绑定或自定义中间件修改了 request，确保
request()能正确读取原始查询
前端 Blade 模板里怎么安全渲染分页链接
别手写 <a href="?page=2">，Laravel 自带的 links() 方法已处理好逻辑，但默认样式可能不匹配你的 CSS 框架：
{{ $users->links('pagination::bootstrap-5') }}
- Laravel 9+ 内置支持
bootstrap-4、bootstrap-5、tailwind三种视图，路径分别是resources/views/vendor/pagination/xxx.blade.php - 如需自定义，先运行
php artisan vendor:publish --tag=laravel-pagination导出模板再修改 - 如果项目用的是 Alpine + Tailwind，注意原生
links()渲染的<span>标签没有aria-current，需手动补上或改用simplePaginate()+ 自己拼接 - 移动端慎用
simplePaginate()，它不提供总页数，无法显示「第 x 页，共 y 页」
什么时候该用 simplePaginate() 而不是 paginate()
simplePaginate() 只查下一页是否存在（LIMIT 16），不执行 COUNT(*)，性能更高，适合数据量极大、且不需要总页数或「跳转到最后一页」功能的场景：
- 日志列表、消息流、无限滚动 feed
- 表记录超百万、
COUNT(*)明显拖慢响应（尤其没加合适索引时） - 你只需要「上一页 / 下一页」按钮，不显示页码数字和总条数
- 注意：
simplePaginate()返回的是SimplePaginator，没有lastPage()、total()方法，links()渲染的也是简化版
最常被忽略的一点：分页器默认按主键排序，如果模型没设 $primaryKey 或用了复合主键，paginate() 可能报错或分页错乱；务必确认 orderBy() 显式存在且字段有索引。
