Windows Docker开发环境搭建：启用WSL2安装Ubuntu并与Docker Desktop集成及系统迁移（小白详细教程）

Windows Docker开发环境搭建：启用WSL2安装Ubuntu并与Docker Desktop集成及系统迁移（小白详细教程）

对于希望在Windows上使用Docker进行开发的初学者来说，WSL2安装Ubuntu并与Docker Desktop集成是必备技能。本文将手把手教你从零开始，完成环境搭建并实现Docker系统迁移，最终打造一个高效的Windows Docker开发环境。即使你没有任何基础，按照步骤操作也能成功！

一、准备工作：检查系统要求

确保你的Windows版本为Windows 10 2004及以上（或Windows 11），并且开启了CPU虚拟化（BIOS中启用）。

二、启用WSL2功能

以管理员身份打开PowerShell或命令提示符，输入以下命令：

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

完成后重启电脑。接着下载并安装WSL2内核更新包（https://aka.ms/wsl2kernel）。最后将WSL2设置为默认版本：

    wsl --set-default-version 2  

三、安装Ubuntu发行版

打开Microsoft Store，搜索“Ubuntu”并选择最新LTS版本（如Ubuntu 22.04.3 LTS）进行安装。安装完成后启动，首次启动会提示创建用户名和密码。之后验证WSL版本：

    wsl -l -v  

确保Ubuntu的版本为2。如果不是，执行：wsl --set-version Ubuntu 2

四、安装Docker Desktop并配置WSL2集成

从Docker官网下载Docker Desktop for Windows，安装时确保勾选“Use WSL 2 instead of Hyper-V”。安装完成后启动Docker Desktop，进入Settings → General，勾选“Use the WSL 2 based engine”。然后在Resources → WSL Integration中，启用你要与Docker集成的Ubuntu发行版。如下图所示：

至此，你已经完成了WSL2安装Ubuntu并与Docker Desktop集成，可以在Ubuntu终端中直接运行docker命令了。

五、系统迁移：将Docker数据移到其他盘

默认情况下，Docker的镜像和容器数据存储在C盘，随着使用会占用大量空间。我们可以通过迁移WSL2的虚拟磁盘文件来实现Docker系统迁移。以下是详细步骤：

1. 完全退出Docker Desktop（右键任务栏图标选择“Quit Docker Desktop”）。
2. 打开PowerShell（管理员），查看当前WSL分发：

   wsl --list --verbose

   你会看到两个与Docker相关的分发：docker-desktop和docker-desktop-data。我们需要迁移的是docker-desktop-data（存储镜像和容器）。
3. 在D盘（或其他盘）创建目标文件夹，例如D:\Docker\wsl\data。
4. 导出当前分发为tar文件（注意替换路径）：

   wsl --export docker-desktop-data D:\Docker\wsl\docker-desktop-data.tar

5. 注销原有分发：

   wsl --unregister docker-desktop-data

6. 将tar导入到新位置：

   wsl --import docker-desktop-data D:\Docker\wsl\data D:\Docker\wsl\docker-desktop-data.tar --version 2

7. 删除临时tar文件。
8. 重新启动Docker Desktop，检查是否正常运行。可以使用docker info验证。

迁移后，所有Docker数据都保存在D盘，C盘空间得到释放。这一技巧对于长期使用Docker的用户尤为重要。

六、验证与总结

现在，你已经成功在Windows上通过WSL2安装Ubuntu并与Docker Desktop集成，还完成了Docker系统迁移。整个Windows Docker开发环境搭建完毕！你可以在Ubuntu终端中运行docker run hello-world测试。希望本文对你有帮助，如果有任何问题，欢迎在评论区交流。

（注：本文所有命令均在管理员权限下执行，请仔细核对路径。）