可用 Laravel Shift 自动升级 Laravel 12 到 13，但需手动满足 PHP ≥ 8.3、项目稳定在 12.40+、测试通过且 Git 已打标签；Shift 不处理 PHP 升级、Attributes 迁移、JSON:API 启用、Queue::route() 配置等，需人工验证和补充。
你可以用 Laravel Shift 完成 Laravel 12 到 13 的自动化迁移，但需注意：Laravel Shift 主要面向 Laravel 12 及更早版本升级到 Laravel 13 的结构与配置调整，不处理 PHP 版本升级或 Attributes 语法迁移等开发层重构。
准备前提条件
确保项目满足 Laravel 13 的最低要求：
- PHP 版本 ≥ 8.3（Shift 不会自动升级 PHP，需手动完成）
- 当前应用稳定运行在 Laravel 12.x（建议先升级至 12.40+ 最新补丁版）
- 所有测试通过，且 migrations 表状态干净（
php artisan migrate:status无失败或未执行项） - Git 已提交当前代码并打好标签（如
v12.40.0），便于 Shift 回溯对比
使用 Shift 执行升级流程
进入 laravelshift.com，按步骤操作：
- 登录 GitHub 账户，授权 Shift 访问你的仓库（仅限私有仓库需手动配置 SSH 或 PAT）
- 选择目标仓库，点击 “Upgrade to Laravel 13”
- Shift 将自动拉取代码、分析依赖、检测自定义类/重写方法，并生成差异报告
- 确认无高危冲突（如自定义 Artisan 命令签名变更、中间件参数调整）后，点击 “Apply Shift”
- Shift 推送一个含完整变更的 Pull Request：包括
composer.json更新、配置文件适配、废弃 Facade 替换、以及app/Providers/AppServiceProvider.php等关键文件的修改
升级后必须手动验证的关键点
Shift 生成的代码能覆盖大部分兼容性调整，但以下事项需开发者介入：
-
PHP Attributes 迁移非强制：Shift 不会将模型中的
$fillable、$hidden等属性转为#[Fillable]，如需启用新语法，须人工重写 -
JSON:API Resources 需主动启用：Shift 不会自动替换现有 Resource 类，若要用内置 JSON:API 支持，需手动继承
JsonApiResource并调整响应逻辑 -
队列路由配置：
Queue::route()是新增 API，Shift 不会插入默认路由规则，需根据业务在AppServiceProvider::boot()中补充 -
测试与 CI 适配：检查 PHPUnit 配置是否兼容 PHP 8.3，更新
phpunit.xml中的coverage路径及最低 PHP 版本声明
替代方案：Laravel Boost + AI 辅助
如果你已安装 Laravel Boost ^2.0，可在 VS Code 或 Cursor 中直接运行 /upgrade-laravel-v13 命令。它会实时分析代码上下文，提示 Attributes 转换建议、JSON:API 重构路径、以及 Queue::route() 示例写法——更适合渐进式升级或局部重构。
