直接用 sail 安装 laravel 10 非常简单，核心是“先建项目、再启容器”，全程无需本地安装 php 或数据库；推荐使用官方一键脚本 curl -s https://laravel.build/my-app | bash 创建项目，cd my-app 后执行 ./vendor/bin/sail up -d 启动，linux 访问 http://localhost，macos/windows wsl2 需 hosts 绑定 laravel.test 并访问 http://laravel.test。
直接用 Sail 安装 Laravel 10 非常简单，核心是“先建项目、再启容器”，全程不需要本地装 PHP 或数据库。
快速创建带 Sail 的 Laravel 10 项目
推荐使用官方一键脚本，它会自动拉取 Laravel 10 对应的稳定版，并预装 Sail：
- 运行命令：curl -s https://laravel.build/my-app | bash
- 进入项目：cd my-app
- 启动服务：./vendor/bin/sail up -d
完成后访问 http://localhost（Linux）或 http://laravel.test（macOS/Windows WSL2，需提前加 hosts：运行 sudo sh -c "echo '127.0.0.1 laravel.test' >> /etc/hosts"）
确认 Laravel 10 版本与 Sail 兼容性
Laravel 10 要求 PHP ≥ 8.1，Sail 默认提供 PHP 8.2 或 8.3 运行时。安装后可验证：
- 查看 composer.json 中
"laravel/framework": "^10.0" - 运行 ./vendor/bin/sail php --version，输出应为 PHP 8.2.x 或 8.3.x
- 若需指定 PHP 版本，可在创建时加参数：curl -s "https://laravel.build/my-app?php=83" | bash
启动后常见检查项
容器跑起来不等于全通，这几个点最容易卡住：
- .env 中数据库配置必须匹配服务名：DB_HOST=mysql（不是 localhost 或 127.0.0.1），DB_PORT=3306
- 确认 mysql 容器已就绪：运行 ./vendor/bin/sail ps，mysql 状态应为 Up，不是 Restarting
- 首次迁移需进容器执行：运行 ./vendor/bin/sail artisan migrate（Sail 自动路由到 apache 容器内）
- 静态资源未编译？：前端用 Vite 的话，运行 ./vendor/bin/sail npm install && ./vendor/bin/sail npm run dev
后续开发常用操作
所有命令都在容器里执行，环境完全一致：
- sail artisan make:controller —— 生成控制器
- sail tinker —— 进入交互式 PHP 环境
- sail composer require guzzlehttp/guzzle —— 安装扩展包
- sail shell —— 进入 apache 容器 Bash，排查路径或权限问题
不需要全局 PHP、Composer 或 Node.js，所有依赖都封装在容器中。
