使用 Laravel Sail 可通过 Docker 一键搭建含 Nginx、MySQL、Redis 和 Node.js 的 Laravel 开发环境，支持新建项目自动集成（laravel new --sail / curl 脚本 / composer create-project --sail）或为现有项目手动添加（composer require laravel/sail --dev + php artisan sail:install），启动后访问 https://www.php.cn/link/bb122c8fe6c764e8aae555e2186a6344 即可验证成功。
要在本地快速获得一个开箱即用、包含 Nginx、MySQL、Redis 和 Node.js 的 Laravel 开发环境，无需手动安装 PHP 或数据库服务，只需通过 Laravel Sail 一条命令创建项目并完成容器初始化——整个过程依赖 Docker，不污染系统环境，且所有服务版本预对齐。
新建项目并自动启用 Sail
执行以下任一命令，Sail 配置将随项目一同生成，无需后续补装：
方法一（推荐）：使用 Laravel 安装器（需全局安装 laravel/installer）
运行 laravel new my-app --sail，该命令会拉取最新 Laravel 框架，并自动生成 docker-compose.yml 和可执行的 sail 脚本。
方法二：使用 cURL 快速脚本（适合 macOS/Linux）
运行 curl -s https://laravel.build/my-app | bash，脚本会自动创建目录、下载代码、设置权限，并预置 Sail 所需全部文件。
方法三：用 Composer 创建（兼容性最广）
运行 composer create-project laravel/laravel my-app --prefer-dist --sail，【--sail 参数不可省略】，否则不会生成 docker-compose.yml 和 sail 入口文件。
为已有 Laravel 项目添加 Sail 支持
若你手头已有 Laravel 项目（例如从 Git 克隆或旧版升级而来），需分两步手动接入 Sail：
第一步：安装 Sail 开发依赖
在项目根目录下运行 composer require laravel/sail --dev。这一步必须先做，否则下一步会报错“command not found”。
第二步：初始化 Sail 配置
运行 php artisan sail:install，终端将列出 MySQL、PostgreSQL、Redis、Meilisearch、MailHog 等服务选项，用空格键勾选需要的服务，回车确认。该命令会生成 docker-compose.yml 并在项目根目录创建可执行的 sail 脚本。
注意：如果项目是 Laravel 8 之前版本（如 7.x），请先升级至 Laravel 8+ 再执行上述操作，低版本不兼容 Sail 命令。
启动容器并验证运行
① 进入项目根目录：cd my-app
② 启动所有服务：./vendor/bin/sail up（首次运行会自动拉取镜像，耗时约 2–5 分钟）
③ 等待终端输出类似 Attaching to my-app-nginx-1, my-app-mysql-1, ... 且不再滚动日志后，在浏览器访问 https://www.php.cn/link/bb122c8fe6c764e8aae555e2186a6344 ——看到 Laravel 欢迎页面即表示成功。
④ （可选）为简化命令，可配置 shell 别名：echo "alias sail='[ -f sail ] && sh sail || sh vendor/bin/sail'" >> ~/.zshrc && source ~/.zshrc，之后直接输入 sail up 即可。
