启用 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 --set-default-version 2

安装 Linux 发行版

从 Microsoft Store 下载并安装 Ubuntu 或 Debian 等 WSL 支持的发行版。安装完成后，启动发行版完成初始化设置。

安装 Docker Desktop

从 Docker 官网下载 Docker Desktop for Windows，安装时勾选 "Use WSL 2 based engine" 选项。安装完成后启动 Docker Desktop。

配置 WSL 与 Docker 集成

在 Docker Desktop 设置中，进入 Resources → WSL Integration，启用已安装的 Linux 发行版。确保 WSL 2 为默认版本：

wsl --set-version <发行版名称> 2

验证安装

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

docker --version
docker run hello-world

常见问题处理

若遇到权限问题，将当前用户加入 Docker 组：

sudo usermod -aG docker $USER

若 WSL 2 无法启动，检查 BIOS 中虚拟化功能（Intel VT-x/AMD-V）是否启用。

性能优化建议

在 Docker Desktop 设置中调整 CPU 和内存资源分配，避免与主机系统资源冲突。将项目文件存储在 WSL 文件系统内（如 /home/ 目录）而非 Windows 挂载路径（如 /mnt/c/），以提升 I/O 性能。