Windows 环境下安装 Docker WSL2 Ubuntu

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

文章目录

• • • 1\\. 前言
    • 2\\. 安装前的准备
    • • 2.1 检查 Windows 版本
      • 2.2 确认虚拟化已开启
      • • 检查方法：
    • 3\\. 安装 Docker Desktop
    • • 3.1 下载
      • 3.2 安装步骤
    • 4\\. 启用 WSL2（家庭版必看）
    • • 4.1 安装 WSL2
      • 4.2 设置 WSL2 为默认版本–（该步骤可省略）
      • 4.3 安装一个 Linux 发行版（推荐 Ubuntu）–该步骤也可省略
    • 5\\. 启动 Docker Desktop，（已更新 WSL ，直接点restart即可）
    • 6\\. 验证安装
    • 7\\. 常见问题解决
    • • 问题1：Docker 启动报错 “WSL 2 installation is incomplete”
      • 问题2：虚拟化未开启
      • 问题3：家庭版不支持 Hyper-V
    • 8\\. 学习
    • • docker相关命令
      • wsl相关命令

1. 前言

Docker 是一个开源的应用容器引擎，可以让开发者将应用及其依赖打包到一个可移植的 镜像 中，然后在任意环境中运行。 在 Windows 下安装 Docker 的方式主要是通过 Docker Desktop，它支持 WSL2 技术，大幅提高性能。

2. 安装前的准备

2.1 检查 Windows 版本

Docker Desktop 要求：

• Windows 10（64 位）专业版 / 企业版（Build 19041 及以上）

• Windows 11（64 位）专业版 / 企业版

• 家庭版需先开启 WSL2（后面会讲）

📌 检查方法：

Win + R → 输入 winver → 回车

2.2 确认虚拟化已开启

Docker 依赖虚拟化技术，需要确保 BIOS 中已启用虚拟化（Intel VT-x / AMD-V）。

检查方法：

❗ 如果显示“已禁用”，需要重启电脑进入 BIOS 开启虚拟化。

3. 安装 Docker Desktop

3.1 下载

前往 Docker 官方下载页面： 🔗 Docker Desktop: The #1 Containerization Tool for Developers | Docker

选择 Windows 版本，点击 Download for Windows。

建议下载最新版，兼容性更好。

3.2 安装步骤

• Install required Windows components for WSL 2

• Add shortcut to desktop

4. 启用 WSL2（家庭版必看）

如果你是 Windows 10/11 家庭版 或者第一次安装 Docker Desktop，需要启用 WSL2。

4.1 安装 WSL2

方法一：在 PowerShell（管理员模式）中输入：

wsl –install

等待系统自动安装 Linux 子系统和 WSL2 内核。 装wsl_update_x64.msi 更新最新安装方式，直接下载安装包 双击安装即可， 下载地址

4.2 设置 WSL2 为默认版本–（该步骤可省略）

wsl –set-default-version 2

4.3 安装一个 Linux 发行版（推荐 Ubuntu）–该步骤也可省略

管理员打开命