Laravel 13 尚未发布，当前最新稳定版是 Laravel 12（2024年9月发布），预计2025年9月正式发布；若执行 php artisan --version 显示 13.x-dev 或 dev-main，则为不稳定开发分支，不适用于生产环境。
目前（2026年9月）Laravel 13 尚未发布，官方最新稳定版是 Laravel 12（2024年9月发布），Laravel 13 的正式发布时间预计在 2025 年 9 月左右。所以你现在在 Mac 上尝试“配置 Laravel 13”，实际会遇到两种情况：要么拉取的是开发分支（dev-main），不稳定且无文档保障；要么是误信了非官方渠道的虚假版本信息。请先确认你真正需要的是 Laravel 12，还是确有特殊需求必须试用未发布的主干代码。
如何验证你拿到的真是 Laravel 13？
执行以下命令检查实际版本：
cd your-laravel-project php artisan --version
如果输出类似 Laravel Framework 13.x-dev 或 dev-main，说明你当前在使用未发布的开发分支——它不适用于日常开发或生产环境。Laravel 官方从不为未发布的主干提供安装包、文档支持或安全更新。
- 所有 Laravel 13 的变更都在 GitHub 的
laravel/framework仓库main分支上，但该分支仅用于内部开发和 CI 测试 - Composer 默认不会安装
dev-main，除非你显式指定"laravel/framework": "dev-main"并禁用稳定性约束 - 运行
composer create-project laravel/laravel example --stability=dev --prefer-dist仍只会得到 Laravel 12.x，因为 Packagist 上尚未发布 13.x 版本号
Mac 上正确安装 Laravel 12（当前最新稳定版）
这才是你应该落地的操作路径。核心工具链没变，但要注意 PHP 版本要求已升至 ^8.2（Laravel 12 不再支持 PHP 8.1 及更早版本）：
- 确保 Homebrew 已就位：
brew --version - 安装 PHP 8.2+：
brew install php@8.3（推荐 8.3，兼容性更好） - 安装 Composer：
brew install composer - 创建项目：
composer create-project laravel/laravel example-app - 启动内置服务器：
cd example-app && php artisan serve
注意：php artisan serve 在 macOS 上默认绑定 127.0.0.1:8000，若需外部访问（如 iOS 模拟器调试），加参数 --host=0.0.0.0 --port=8000，并确认系统防火墙允许该端口。
如果你坚持要跑 Laravel dev-main（不推荐）
仅限研究源码或参与贡献，且必须接受频繁 break、无向后兼容、文档缺失等现实：
- 先清空 Composer 缓存：
composer clear-cache - 创建空目录，手动初始化：
composer init，然后编辑composer.json，把"laravel/framework"行改为："laravel/framework": "dev-main as 13.0.0" - 强制安装：
composer install --ignore-platform-reqs（因依赖可能声明不支持你的 PHP 版本） -
.env文件必须存在，否则artisan会直接报错退出；可用cp .env.example .env快速补全 - 首次运行前务必执行：
php artisan key:generate，否则所有请求返回 500
这种配置下，任何第三方包（如 laravel/sanctum、spatie/laravel-permission）大概率无法正常 require，因为它们尚未适配未发布的框架接口。
真正需要多版本切换或隔离时，别碰 dev-main，改用 laravel valet use php@8.2 或 Docker Compose 管理不同 PHP + Laravel 组合——稳定、可复现、团队可协作。Laravel 13 的价值不在“现在能跑”，而在它正式发布后带来的新契约，比如对 PHP 8.4 原生特性的深度整合，那才是值得等待的地方。
