启用 WSL 功能

打开 PowerShell(管理员权限),执行以下命令启用 WSL 功能并重启计算机:

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

安装 WSL 2 内核更新

从微软官网下载并安装 WSL 2 Linux 内核更新包,完成后执行以下命令将 WSL 默认版本设置为 2:

wsl --set-default-version 2

安装 Linux 发行版

打开 Microsoft Store,搜索并安装 Ubuntu 或 Debian 等 Linux 发行版。安装完成后启动发行版,完成初始用户名和密码设置。

安装 Docker Desktop

下载 Docker Desktop for Windows,安装时勾选 Use WSL 2 based engine 选项。安装完成后启动 Docker Desktop,在设置中确认 WSL 2 集成已启用。

验证安装

在 PowerShell 中运行以下命令验证 Docker 和 WSL 2 是否正常工作:

docker --version
wsl -l -v

若输出显示 Docker 版本和 WSL 2 发行版状态,则安装成功。

常见问题解决

  • WSL 2 无法启动:确保 BIOS 中启用虚拟化(VT-x/AMD-V),并检查 Hyper-V 是否已启用。
  • Docker 命令权限问题:将用户加入 docker-users 组,或通过 WSL 终端执行命令。
  • 性能优化:在 Docker Desktop 设置中调整资源限制(CPU/内存),避免与 WSL 2 冲突。

通过以上步骤,可在 Windows 上快速搭建基于 WSL 2 的 Docker 开发环境,显著提升容器运行效率。

更多推荐