启用 WSL 功能

在 Windows 搜索栏输入“启用或关闭 Windows 功能”，勾选“适用于 Linux 的 Windows 子系统”和“虚拟机平台”选项。完成勾选后重启计算机。

安装 WSL 2 发行版

打开 PowerShell 或命令提示符，执行以下命令安装默认的 Ubuntu 发行版：

wsl --install

如需指定其他发行版（如 Debian），使用：

wsl --install -d Debian

安装完成后通过 wsl --set-default-version 2 确保默认使用 WSL 2。

安装 Docker Desktop

访问 Docker 官网下载 Windows 版 Docker Desktop。安装时勾选“Use WSL 2 instead of Hyper-V”选项。安装完成后启动 Docker Desktop，在设置中导航到 Resources > WSL Integration，启用已安装的 WSL 发行版。

验证安装

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

docker run --rm hello-world

若看到“Hello from Docker!”的输出，表明安装成功。

配置开发环境（可选）

为提升性能，建议将项目文件存储在 WSL 文件系统中（如 /home/username/projects），而非 Windows 的挂载目录（/mnt/c）。可通过以下命令在 WSL 中创建项目目录并挂载：

mkdir -p ~/projects && cd ~/projects

常见问题处理

若遇到网络问题，尝试在 Docker Desktop 设置中配置国内镜像源（如阿里云镜像）。示例配置：

{
  "registry-mirrors": ["https://<your-mirror-id>.mirror.aliyuncs.com"]
}

若 WSL 启动失败，检查 BIOS 中是否启用虚拟化（Intel VT-x/AMD-V）。部分安全软件可能需临时关闭。