使用路由前缀可实现Laravel API版本控制，通过分组、命名空间分离及资源类统一响应格式，推荐路径前缀方式以确保清晰与可维护性。
在构建 Laravel API 时，随着业务发展，接口需要迭代更新。为了保证旧客户端的兼容性，同时支持新功能发布，API 版本控制变得必不可少。Laravel 虽然没有内置版本化路由系统，但通过合理的结构设计和路由配置，可以轻松实现版本控制。
1. 使用路由前缀进行版本划分
最常见且推荐的方式是利用 路由前缀（route prefix） 来区分不同版本的 API。Laravel 的路由分组机制让这一做法非常简洁高效。
在 routes/api.php 中，你可以按版本分组：
Route::prefix('v1')->group(function () {
Route::get('users', [V1\UserController::class, 'index']);
Route::post('users', [V1\UserController::class, 'store']);
});
Route::prefix('v2')->group(function () {
Route::get('users', [V2\UserController::class, 'index']); // 可能返回更多字段
Route::post('users', [V2\UserController::class, 'store']);
});
这样，请求 /api/v1/users 和 /api/v2/users 就会分别进入对应版本的控制器，互不干扰。
2. 控制器与命名空间分离
为避免代码混乱，建议将不同版本的控制器放在独立的命名空间下。例如：
app/
└── Http/
└── Controllers/
└── Api/
├── V1/
│ └── UserController.php
└── V2/
└── UserController.php
然后在 RouteServiceProvider 或路由文件中注册命名空间：
Route::middleware('api')
->namespace('App\Http\Controllers\Api\V1')
->prefix('v1')
->group(base_path('routes/api_v1.php'));
你也可以为每个版本创建单独的路由文件，便于管理。
3. 响应格式统一与数据转换
不同版本的 API 可能返回结构不同的数据。使用 资源类（Resource） 可以优雅地处理这种差异。
例如：
// v1 返回基础信息 return new UserResource($user); // v2 返回扩展信息 return new V2UserResource($user);
通过资源类封装响应结构，既能保持逻辑清晰，又方便未来扩展。
4. 版本控制的其他方式对比
除了 URL 路径前缀，还有几种常见的版本控制方式：
-
请求头版本控制：通过自定义 header 如
Accept: application/vnd.myapp.v2+json判断版本。适合不想暴露版本号在 URL 的场景，但调试不便。 -
查询参数版本控制：如
?version=v2。简单但不够规范，不利于缓存和日志分析。
综合来看，URL 路径前缀（如 /v1/...） 是最直观、易调试、易缓存的方式，也是 Laravel 社区广泛采用的实践。
基本上就这些。合理使用路由分组、命名空间和资源类，就能在 Laravel 中实现清晰、可维护的 API 版本控制。关键是提前规划结构，避免后期重构成本。
