Laravel分页URL美化需自定义UrlGenerator并配合路由绑定，用withPath()设干净路径，而非改模板；CursorPaginator不适用此场景，因其用游标且不支持页码跳转。
分页 URL 里怎么去掉 ?page=2 这种参数
默认 Laravel 分页生成的链接是 /users?page=2，但 SEO 或路由一致性要求它变成 /users/page/2 或 /users/2。这不是改模板就能解决的，得从分页器构造环节干预。
核心思路是：不靠 LengthAwarePaginator 默认的 URL 生成逻辑，而是用自定义 UrlGenerator 替换掉它的 setPath() 行为，再配合路由绑定让分页器“以为”当前路径已含页码。
- 在路由中显式声明页码段，比如
Route::get('/users/page/{page?}', [UserController::class, 'index'])->name('users.index'); - 控制器里手动构建分页器时，传入不含查询参数的干净路径：
$users->withPath(url('users.page', ['page' => null])); - 关键点：
withPath()的值必须和实际访问路径一致（不含page参数），否则分页器会自己补上?page=
Laravel 10+ 用 CursorPaginator 能绕开 URL 美化问题吗
不能。游标分页（CursorPaginator）根本不用页码，它用 ?cursor=xxx 做状态传递，URL 结构更不可读，且无法跳转任意页——它和「美化页码 URL」是两个方向的问题。
如果你要的是「可预测、可书签、支持 SEO 的页码导航」，就必须用 LengthAwarePaginator，并控制它的路径生成逻辑。
-
CursorPaginator适合无限滚动或大数据集的性能敏感场景，不是 URL 美化的替代方案 - 它不接受
withPath()，也不响应setPath()，因为它的 URL 构建逻辑硬编码在url()方法里 - 强行给游标分页加
/page/2路由会导致分页器内部状态错乱，翻页失效
自定义分页器 URL 时最容易踩的三个坑
多数人卡在“看起来改了，但点击后还是跳回 ?page=”，问题往往不在代码，而在路径匹配和上下文不一致。
- 路由命名没对齐：
withPath()里写的 URL 必须和当前请求的request()->fullUrl()解析出的 base path 完全一致，大小写、末尾斜杠都不能差 - 中间件干扰：某些权限中间件或语言切换中间件会重定向并丢掉原始 URL 上下文，导致分页器 fallback 到默认逻辑
- 视图里用了
$users->links()却没传自定义渲染器：Laravel 默认分页视图仍会调用$paginator->url($page)，而这个方法依赖你之前设好的withPath()；如果漏设，它就退回到 query string 模式
怎么让分页链接生成 /users/2 而不是 /users/page/2
可以，但得接受一个限制：这种扁平路径会让路由定义变得脆弱，尤其是当资源 ID 也是数字时（比如 /users/2 可能被误认为是用户详情页）。
实现上只需两步：路由定义用可选参数 + 控制器内动态判断；分页器路径设为根级。
- 路由写成
Route::get('/users/{page?}', [UserController::class, 'index'])->where('page', '[0-9]+')->name('users.index'); - 控制器里区分请求类型：
if (is_numeric($page) && $page > 1) { $users = User::paginate(15)->withPath(url('users.index', ['page' => null])); } - 注意：首页不能带
/1，否则 SEO 重复内容；withPath()的null值会让第一页链接变成/users，其余页才是/users/2、/users/3
复杂点在于，所有分页链接必须严格遵循这个路径结构，稍有偏差（比如某处漏传 ['page' => null]），整个链路就退回 query string。它不是配置开关，而是每个分页实例都要手动对齐的契约。
