Laravel Sail 开发环境部署一把过（环境配置篇）

部署目标

本文将从零开始构建基于 WSL2 （Windows Subsystem for Linux 2） 的标准化 Docker 开发环境，并完成首个 Laravel Sail 项目的初始化。

环境要求：

• OS: Windows 11 （Build 22000+） 或 Windows 10 （Build 19041+）.
• BIOS: 开启 CPU 虚拟化 （Virtualization Technology）.

---

1. 基础设施准备

1.1 验证虚拟化支持

Docker Desktop 依赖 Hypervisor 层支持。请确保 BIOS/UEFI 中已开启虚拟化（Intel VT-x 或 AMD-V）。

• 验证方式：任务管理器 -> 性能 -> CPU -> 虚拟化：已启用。

1.2 部署 WSL2

使用管理员权限打开 PowerShell 或 Windows Terminal，执行以下指令完成 WSL2 及 Ubuntu 发行版的自动安装：

wsl --install

Note: 安装完成后需重启系统。重启后会自动弹出终端窗口，按提示设置 UNIX 用户名与密码即可。

1.3 安装 Docker Desktop

下载并安装 Docker Desktop for Windows。

关键配置检查：
安装向导中务必勾选 Use WSL 2 instead of Hyper-V（通常为默认选中）。
启动后，进入 Settings -> Resources -> WSL Integration：

1. 确保 Enable integration with my default WSL distro 为开启状态。
2. 在下方 distro 列表中，确保 Ubuntu 处于开启状态。

---

2. 初始化 Laravel Sail 项目

所有后续操作建议直接在 WSL2 终端（Ubuntu）中执行，以获得原生的 Linux 开发体验。

2.1 创建工作区

建议在 WSL 用户主目录下统一管理项目，避免 Windows 文件系统 （NTFS） 挂载带来的 I/O 性能损耗。

mkdir -p ~/code && cd ~/code

2.2 构建项目

使用 Laravel 官方构建脚本初始化项目（通过临时 Docker 容器）：

# 请将 'example-app' 替换为实际项目名
curl -s https://laravel.build/example-app | bash

该指令会自动拉取 php-cli 镜像及相关依赖。

2.3 配置 Shell Alias （推荐）

为简化操作，建议将 sail 执行脚本映射为 Shell 别名。编辑 ~/.bashrc 或 ~/.zshrc：

# 添加至配置文件末尾
alias sail='[ -f sail ] && bash sail || bash vendor/bin/sail'

加载生效：

source ~/.bashrc

---

3. 启动与验证

3.1 启动环境

进入项目目录并后台启动 Sail 服务栈：

cd ~/code/example-app
sail up -d

Sail 将根据 docker-compose.yml编排启动 PHP、MySQL、Redis 等容器。首次启动涉及镜像拉取，耗时取决于网络环境。

3.2 服务验证

服务启动后，通过宿主机浏览器访问 http://localhost。
若显示 Laravel 欢迎页，即表示：

• ✅ Docker 容器运行正常
• ✅ 端口转发 （Port Forwarding） 正常
• ✅ PHP 运行时挂载正常

---

下一步

基础环境已就绪。下一章节我们将讨论多端协作场景：如何基于 Git 管理代码，并在不同设备间实现无缝的依赖引导与环境同步。