启用 WSL 功能

以管理员身份打开 PowerShell，执行以下命令启用 WSL 功能：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

完成后重启系统。

安装 Linux 发行版

打开 Microsoft Store，搜索并安装 Ubuntu 或其他 preferred 发行版。安装完成后启动，按提示创建用户名和密码。

更新 WSL 内核

下载最新 WSL 2 内核更新包并安装：

wsl --update

设置默认版本为 WSL 2：

wsl --set-default-version 2

安装 Docker Desktop

从 Docker 官网下载 Docker Desktop for Windows 安装包。安装时勾选以下选项：

• "Use WSL 2 based engine"
• "Install required Windows components for WSL 2"

配置 WSL 与 Docker 集成

打开 Docker Desktop 设置，导航到 Resources > WSL Integration，启用已安装的 Linux 发行版。点击 Apply & Restart。

验证安装

在 WSL 终端运行以下命令验证 Docker 是否正常工作：

docker run hello-world

若看到欢迎消息，则安装成功。

常见问题排查

• WSL 2 未生效：运行 wsl -l -v 确认发行版使用 WSL 2。
• 权限问题：将用户加入 docker 组：

  sudo usermod -aG docker $USER
  

• 网络问题：在 Docker Desktop 设置中重置网络或重启服务。