Route::prefix() 必须与 group() 配合使用，单独调用无效；前缀不加结尾斜杠，动态段需显式传参，命名需用 name('prefix.') 显式层级化。
必须用 Route::group() 包裹，prefix 是配置项，不是链式方法；单独给单个路由加 prefix() 或写在控制器里完全无效。
Route::prefix() 为什么不能单独调用？
Route::prefix('api') 本身不注册任何路由，它只是返回一个路由构建器实例，必须配合 ->group() 才会真正生效。很多人误写成：
Route::prefix('api')->get('users', [UserController::class, 'index']);
这行代码不会产生 /api/users 路由，Laravel 会忽略 prefix() 调用，只注册 /users。
-
Route::prefix()必须和->group()配套使用：正确写法是Route::prefix('api')->group(function () { Route::get('users', ...); }); - 也可以把
prefix写进Route::group()的第一个参数数组里：Route::group(['prefix' => 'api'], function () { ... }); - 两种写法等价，但后者更明确体现“分组配置”的语义，也更易统一管理中间件、命名空间等其他选项
前缀字符串要不要加开头或结尾斜杠？
开头斜杠可加可不加，Laravel 会自动标准化；结尾斜杠一定不要加——否则可能拼出双斜杠（如 prefix('api/') + get('users') → /api//users），虽多数情况仍能匹配，但不符合 URL 规范，且容易在重定向、CDN 缓存或前端路由中引发歧义。
- 推荐写法：
prefix('api')或prefix('/api')（二者最终都生成/api/xxx） - 禁止写法：
prefix('api/')、prefix('/api/')、get('/users')（子路由路径开头也不加/） - 多级嵌套时，各层
prefix会拼接：prefix('admin') → prefix('users')→ 实际路径为/admin/users/xxx
动态前缀（如 {tenant}）怎么传参？
动态段不是“可选装饰”，而是强制要求：所有该组内用 route() 生成 URL 的地方，都必须显式传入对应参数值，否则抛出 MissingRequiredParameterException。
- 定义：
Route::prefix('{tenant}')->group(function () { Route::get('dashboard', ...)->name('dashboard'); }); - 错误调用：
route('dashboard')→ 报错 - 正确调用：
route('dashboard', ['tenant' => 'acme']) - 即使用了
{tenant?}，Laravel 也不会跳过参数，必须传null或空字符串：route('dashboard', ['tenant' => null]) - 参数名大小写敏感，且必须和前缀中定义的一致，不能写成
['Tenant' => 'acme']
路由名（name）怎么和前缀联动？
prefix 不影响路由名，要让名字也带层级，必须显式用 ->name('api.')（注意末尾的点），再在组内每个 name() 中只写局部名。
- 正确组合：
Route::prefix('api')->name('api.')->group(function () { Route::get('users', ...)->name('users.index'); });→ 最终名为api.users.index - 漏掉点：
->name('api')→ 名字变成apiusers.index，route('api.users.index')查不到 - 重复加点：
->name('api.')->name('v1.')→ 变成api..v1.users.index，多余点号导致解析失败 - 验证是否生效：运行
php artisan route:list，看Name列是否符合预期
最容易被忽略的是：前缀和命名前缀是两套独立机制，prefix 管路径，name() 管标识，缺一不可；而中间件必须显式声明，不会继承——哪怕你全局绑了 api 中间件，prefix('v2') 的组也得自己写 ->middleware('api')，否则认证、CSRF、限流全失效。
