安装 WSL 2

确保 Windows 10 版本为 2004 或更高，或 Windows 11。以管理员身份打开 PowerShell，运行以下命令启用 WSL 功能：

wsl --install

重启系统后，WSL 2 会自动安装默认的 Linux 发行版（通常是 Ubuntu）。

设置默认 WSL 版本

在 PowerShell 中执行以下命令，确保 WSL 2 为默认版本：

wsl --set-default-version 2

安装 Docker Desktop

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

• Use WSL 2 based engine
• Add shortcut to desktop

安装完成后启动 Docker Desktop，在设置中确认已启用 WSL 2 集成。

验证 Docker 安装

打开 WSL 终端（可通过 wsl 命令或开始菜单中的 Ubuntu 入口），运行以下命令验证安装：

docker --version
docker run hello-world

若看到欢迎信息，说明 Docker 已正确运行。

配置开发环境（可选）

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

ln -s /mnt/c/Users/yourname/projects ~/projects

常见问题处理

若遇到网络问题，在 Docker Desktop 设置中配置国内镜像源：

{
  "registry-mirrors": ["https://registry.docker-cn.com"]
}

权限问题通常通过将用户加入 docker 组解决：

sudo usermod -aG docker $USER