Windows11安装DDEV时WSL2 Ubuntu识别错误求助

问题原因 #

安装脚本通过检测WSL默认发行版的系统标识判断是否为Ubuntu，可能因WSL默认发行版设置未完全生效、或脚本检测逻辑偏差导致误判。

解决步骤 #

1. 强制确认WSL默认发行版为Ubuntu #

在PowerShell中执行命令，确保Ubuntu被设为默认：

wsl --set-default Ubuntu

执行后再次查看发行版列表，确认Ubuntu旁带有*标记：

wsl -l -v

正常输出示例：

NAME                   STATE           VERSION
* Ubuntu                 Running         2
  docker-desktop         Running         2
  docker-desktop-data    Running         2

2. 验证Ubuntu的系统标识 #

在PowerShell中执行命令，检查Ubuntu的系统信息：

wsl cat /etc/os-release

确认输出包含ID=ubuntu和NAME="Ubuntu"，示例片段：

NAME="Ubuntu"
ID=ubuntu
PRETTY_NAME="Ubuntu 22.04.3 LTS"

3. 手动分步骤安装DDEV #

绕过Windows端误判的脚本，分别在WSL Ubuntu和Windows端完成安装：

• WSL Ubuntu环境安装核心组件：
  打开Ubuntu终端（或在PowerShell中执行wsl进入Ubuntu环境），运行Linux安装脚本：

  curl -fsSL https://ddev.com/install.sh | bash
  

• Windows PowerShell安装CLI工具：
  回到PowerShell，执行Windows安装命令：

  iwr -UseBasicParsing https://ddev.com/install.ps1 | Invoke-Expression
  

4. 确认Docker与WSL的集成状态 #

检查Docker Desktop设置：

• 打开Docker Desktop → 设置 → 资源 → WSL集成
• 确保Enable integration with my default WSL distro已勾选，且Ubuntu对应的开关处于开启状态

5. 测试安装结果 #

在WSL Ubuntu中进入任意项目目录，执行：

ddev start

若能正常启动容器，说明安装成功。

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