Laravel Sail运行报错及WSL环境下.env与Docker问题求助

1. 修复.env文件换行符错误 #

克隆项目时Windows与Linux换行符不兼容（Windows为CRLF，Linux为LF），导致WSL执行脚本时出现$'\r': command not found错误。解决方式：

• 直接在WSL终端转换.env文件换行符：

  sed -i 's/\r$//' .env
  

• 配置Git避免后续克隆再出问题：

  git config --global core.autocrlf input
  

  该设置会让Git提交时自动将CRLF转为LF，拉取时保持LF格式，适配WSL环境。

2. 确保Docker在WSL2中正常运行 #

针对“Docker is not running”提示，按以下操作检查：

• 确认Windows上已安装Docker Desktop，且启用WSL2集成：
  打开Docker Desktop设置 → 资源 → WSL集成 → 勾选正在使用的Ubuntu发行版，点击应用保存。
• 在WSL终端验证Docker可用性：

  docker --version
  docker-compose --version
  

  若能输出版本号则说明连接正常；若不行，重启Docker Desktop和WSL终端重试。

3. 在WSL中启动Laravel Sail #

完成上述步骤后，回到项目目录执行：

./vendor/bin/sail up -d

若未安装Sail依赖，先执行：

composer install

（WSL中未安装Composer的话，需先完成Composer安装）

额外注意事项 #

• 不要在MINGW/Git Bash终端运行Sail，Sail仅支持macOS、Linux及WSL2环境，需使用WSL2原生Ubuntu终端。
• 确保WSL2为默认版本：在Windows命令提示符执行wsl --set-default-version 2，若Ubuntu仍为WSL1，执行wsl --set-version Ubuntu 2完成转换。

内容的提问来源于stack exchange，提问作者Alexander Alfaro