Win11 安装 WSL2 + Docker 新手友好教程（官方正版，实测成功）

本文为新手量身打造全程使用官方下载渠道从 WSL2 环境搭建、Docker 安装到 WSL 与 Docker 关联、国内镜像加速再到 Docker 数据迁移避免 C 盘爆满全流程实测成功步骤清晰、无冗余跟着操作就能顺利完成从此开发、部署、运维畅通无阻一、前置准备必看避免踩坑1.1 系统要求操作系统Windows 11 专业版/家庭版均支持实测家庭版可正常使用硬件要求开启 CPU 虚拟化大部分电脑默认开启后续有检查方法内存要求至少 4GB推荐 8GB 及以上避免运行卡顿网络要求可正常访问互联网用于下载官方安装包无需梯子1.2 提前检查 CPU 虚拟化是否开启按下Ctrl Shift Esc打开任务管理器切换到「性能」选项卡点击左侧「CPU」查看右侧「虚拟化」状态显示「已启用」则无需操作显示「已禁用」则需要进入 BIOS 开启不同品牌电脑 BIOS 开启方法不同可百度“自己电脑品牌 开启 CPU 虚拟化”。二、第一步安装 WSL2官方一键安装新手首选Win11 提供了 WSL 一键安装命令无需手动开启功能、下载内核全程自动完成比旧版简单太多2.1 打开管理员 PowerShell按下Win X在弹出的菜单中选择「Windows 终端 (管理员)」如果没有选择「Windows PowerShell (管理员)」也可弹出“用户账户控制”提示点击「是」进入管理员模式标题栏会显示「管理员」。2.2 执行官方一键安装命令在 PowerShell 中输入以下命令回车执行复制粘贴即可避免手滑输错wsl --install命令执行后会自动开启 WSL 相关功能、下载 WSL2 内核、安装默认的 Ubuntu 发行版无需手动选择等待下载安装完成耗时根据网络速度而定约 5-15 分钟完成后会提示「请重启电脑以完成安装」点击「关闭终端」重启电脑。2.3 初始化 Ubuntu 系统电脑重启后会自动弹出 Ubuntu 终端如果没有在开始菜单搜索「Ubuntu」点击打开首次打开会提示“正在安装请勿关闭终端”等待 1-2 分钟初始化完成后会要求设置「用户名」和「密码」用户名小写密码输入时不显示输入完成回车即可记住密码后续使用 WSL 会用到输入密码后Ubuntu 终端即可正常使用说明 WSL2 安装成功。2.4 验证 WSL2 安装成功重新打开管理员 PowerShell输入以下命令wsl -l -v若输出结果中「NAME」为 Ubuntu「STATE」为 Running「VERSION」为 2说明 WSL2 安装成功且正常运行。三、第二步安装 Docker Desktop官方下载无广告Docker 官方提供了 Windows 版 Docker Desktop支持 WSL2 集成全程官方下载无需梯子新手可直接操作。3.1 官方下载 Docker Desktop打开浏览器访问 Docker 官方下载地址国内可直接访问https://www.docker.com/products/docker-desktop/点击页面中的「Download for Windows」按钮自动下载最新版 Docker Desktop 安装包安装包约 600MB耗时根据网络而定下载完成后找到安装包默认在「下载」文件夹双击打开。3.2 安装 Docker Desktop打开安装包后无需修改任何设置默认勾选「Use WSL 2 instead of Hyper-V」正是我们需要的直接点击「OK」等待安装完成约 5-10 分钟安装完成后勾选「Start Docker Desktop when you log in」可选建议勾选开机自动启动 Docker点击「Close and restart」电脑会自动重启。3.3 首次启动 Docker Desktop电脑重启后Docker Desktop 会自动启动首次启动会弹出「服务协议」点击「Accept」接受协议个人非商业使用完全免费启动完成后桌面右下角会出现鲸鱼图标当图标变绿时说明 Docker 正常运行首次启动可能需要 1-2 分钟耐心等待。3.4 验证 Docker 安装成功打开 PowerShell无需管理员权限输入以下命令docker --version若正常输出版本号如 Docker version 29.3.1, build f2d74b7说明 Docker 安装成功。四、第三步关联 WSL2 与 Docker关键步骤实现互通安装完成后需要手动开启 Docker 与 WSL2 的集成才能在 Ubuntu 终端中使用 Docker 命令实现 Windows 和 WSL2 环境互通。3.1 开启 WSL 集成打开 Docker Desktop点击右上角的「Settings」设置图标齿轮形状在左侧菜单中找到「Resources」资源点击子菜单「WSL Integration」WSL 集成在「Enable integration with my default WSL distro」下方找到「Ubuntu」开启右侧的开关变成蓝色即为开启点击右下角的「Apply restart」Docker 会自动重启集成配置生效重启约 1-2 分钟。3.2 验证关联成功打开 Ubuntu 终端输入以下命令docker --version若正常输出版本号说明 WSL2 与 Docker 关联成功再输入以下命令测试 Docker 能否正常运行docker run hello-world若输出「Hello from Docker!」相关信息说明关联完全成功Docker 可在 WSL2 中正常使用。3.3 优化免 sudo 执行 Docker 命令可选提升体验默认情况下在 Ubuntu 终端中执行 Docker 命令需要加sudo输入密码可通过以下命令设置免 sudo提升使用体验# 将当前用户加入 docker 用户组 sudo usermod -aG docker $USER # 刷新组权限无需重启终端 newgrp docker设置完成后再执行docker run hello-world无需输入密码即可正常运行。五、第四步配置国内镜像加速必做解决拉取慢/超时Docker 默认从国外的 Docker Hub 拉取镜像国内网络访问较慢甚至会超时配置国内镜像加速后拉取速度会大幅提升实测秒拉。5.1 配置镜像加速打开 Docker Desktop点击右上角「Settings」→「Docker Engine」将右侧的配置内容替换为以下完整配置复制粘贴即可确保 JSON 格式正确无多余符号{ builder: { gc: { defaultKeepStorage: 20GB, enabled: true } }, experimental: false, features: { buildkit: true }, registry-mirrors: [ https://hub-mirror.c.163.com, https://mirror.aliyuncs.com, https://docker.mirrors.ustc.edu.cn, https://dockerproxy.com ] }点击右下角「Apply restart」Docker 重启后镜像加速生效。5.2 验证镜像加速生效打开 Ubuntu 终端输入以下命令拉取测试镜像docker pull hello-world若几秒内拉取完成说明镜像加速生效若仍超时可检查配置是否正确或重启 Docker 重试。六、第五步Docker 数据迁移到 D 盘必做避免 C 盘爆满Docker 默认将镜像、容器等数据存储在 C 盘长期使用会占用大量 C 盘空间我们将数据迁移到 D 盘提前在 D 盘创建目录D:\ProgramData\Docker\wsl彻底解放 C 盘。6.1 准备工作关闭 Docker Desktop右键桌面右下角鲸鱼图标 →「Quit Docker Desktop」等待完全退出关闭 WSL2打开管理员 PowerShell输入以下命令wsl --shutdown确认 D 盘目录已创建D:\ProgramData\Docker\wsl无则手动创建路径不要有中文、空格。6.2 迁移 C 盘数据到 D 盘打开文件资源管理器进入 C 盘默认数据目录C:\Users\你的用户名\AppData\Local\Docker\wsl右键「wsl」文件夹选择「剪切」注意是剪切不是复制避免占用双倍空间进入 D 盘目录D:\ProgramData\Docker\wsl右键空白处选择「粘贴」等待剪切完成耗时根据数据大小而定剪切完成后C 盘原路径下的「wsl」文件夹会消失数据已全部迁移到 D 盘。6.3 创建符号链接让 Docker 识别 D 盘数据打开管理员 PowerShell输入以下完整命令替换「你的用户名」为自己电脑的用户名直接复制修改即可New-Item -ItemType SymbolicLink -Path C:\Users\你的用户名\AppData\Local\Docker\wsl -Target D:\ProgramData\Docker\wsl执行成功后会提示「符号链接已创建」说明链接生效Docker 会以为数据还在 C 盘实际读取 D 盘数据。6.4 验证迁移成功启动 Docker Desktop等待鲸鱼图标变绿打开 Ubuntu 终端执行docker run hello-world能正常运行说明迁移成功查看 C 盘和 D 盘空间C 盘会释放大量空间D 盘对应增加说明数据已成功迁移。七、全流程验证确保环境完全可用完成以上所有步骤后执行以下操作验证整个环境是否正常打开 Ubuntu 终端执行docker --version正常输出版本号执行docker run hello-world正常拉取并运行执行docker pull nginx拉取 Nginx 镜像几秒内拉取完成镜像加速生效查看 D:\ProgramData\Docker\wsl 目录有数据文件说明数据迁移成功。以上操作均正常说明 Win11 WSL2 Docker 环境搭建完成可正常用于开发、部署、运维。八、新手常见问题排查实测踩坑总结问题1WSL 安装后执行wsl -l -v显示 VERSION 为 1解决打开管理员 PowerShell执行wsl --set-default-version 2然后重启电脑重新查看即可。问题2Docker 启动失败提示“WSL 2 集成异常”解决关闭 Docker 和 WSL执行wsl --shutdown重新启动 Docker再次开启 WSL 集成点击「Apply restart」。问题3Ubuntu 终端执行 Docker 命令提示“permission denied”解决执行「第三步 3.3」的免 sudo 配置命令重新打开终端即可。问题4创建符号链接时提示“ResourceExists”解决确认 C 盘原「wsl」文件夹已剪切到 D 盘C 盘原路径下无「wsl」文件夹再重新执行符号链接命令。问题5镜像加速配置后拉取镜像仍超时解决检查 Docker Engine 配置是否正确JSON 格式无错误、无多余逗号重启 Docker 后重试若仍不行可替换配置中的镜像源。九、总结本教程全程使用官方下载渠道实测 Win11 家庭版/专业版均可正常运行从 WSL2 安装、Docker 安装到关联、加速、数据迁移每一步都针对新手优化避免复杂操作和冗余步骤。完成搭建后你将拥有一套完整、稳定、高效的开发环境Windows 和 WSL2 环境互通Docker 拉取速度飞快数据存储在 D 盘不占用 C 盘空间从此开发、部署、运维畅通无阻