ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

Windows 开启虚拟化 + WSL2 完整安装指南(Docker 前置条件)

Windows 开启虚拟化 + WSL2 完整安装指南(Docker 前置条件)

Windows 开启虚拟化 + WSL2 完整安装指南(Docker 前置条件)

很多新手安装 Docker Desktop 时报错"未检测到虚拟化支持",根本原因是没有开启 BIOS 虚拟化和 WSL2。本文手把手教你从零开启。

适用人群:Windows 用户、Docker 新手、安装 Docker 报错的开发者

测试环境:Windows 10/11,支持 Intel 和 AMD 处理器


一、为什么要开启虚拟化?

Docker Desktop 在 Windows 上依赖两个底层技术:

  1. 硬件虚拟化(VT-x / AMD-V)— BIOS 级别,CPU 必须支持
  2. WSL2(Windows Subsystem for Linux 2)— 微软的 Linux 子系统

不开这两个,Docker 根本跑不起来。

报错信息通常是:

Docker Desktop 启动失败,因为未检测到虚拟化支持。 Contact your IT admin to enable virtualization or check system requirements.

二、第一步:检查虚拟化是否已开启

2.1 快速检查

Ctrl + Shift + Esc打开任务管理器 → 性能 → CPU

看右下角「虚拟化」:

  • 显示「已启用」→ 跳过第三章,直接看第四章
  • 显示「已禁用」→ 继续看第三章

2.2 命令行检查

打开 PowerShell 或 CMD:

systeminfo

找到「Hyper-V 要求」部分:

Hyper-V 要求: 已检测到虚拟机监视器模式扩展: 是 固件中已启用虚拟化: 是 ← 这里显示「是」说明已开启

如果显示「否」,说明需要进 BIOS 开启。


三、第二步:BIOS 开启虚拟化

3.1 各品牌进 BIOS 的按键

品牌开机按哪个键BIOS 界面语言
联想 ThinkPadF1英文
戴尔 DellF2英文
惠普 HPF10英文
华硕 ASUSF2Del英文/中文
微星 MSIDel英文/中文
组装机DelF2看主板品牌

3.2 找到虚拟化选项

Intel CPU 找:

Security → Virtualization → Intel Virtualization Technology (VT-x) 改为:Enabled

有些 BIOS 的路径不同,也可能叫:

  • CPU Configuration → Intel Virtualization Technology
  • Advanced → CPU Setup → Virtualization

AMD CPU 找:

Advanced → CPU Configuration → SVM Mode 改为:Enabled

3.3 保存重启

F10保存并退出(Save and Exit)。

3.4 验证

重启后再次打开任务管理器 → 性能 → CPU → 虚拟化显示「已启用」✅


四、第三步:安装 WSL2

4.1 一键安装(Windows 10 2004+ 或 Windows 11)

管理员身份打开 PowerShell,运行:

wsl--install

这个命令会自动完成:

  • 启用「适用于 Linux 的 Windows 子系统」功能
  • 启用「虚拟机平台」功能
  • 下载并安装 WSL2 内核
  • 安装 Ubuntu(默认发行版)

4.2 重启电脑

安装完成后必须重启才能生效。

4.3 设置 WSL2 为默认版本

重启后再次打开 PowerShell:

wsl --set-default-version2

4.4 验证 WSL2

wsl-l-v

输出示例:

NAME STATE VERSION * Ubuntu Running 2 ← VERSION 必须是 2

如果 VERSION 显示 1,手动转换:

wsl --set-version Ubuntu2

五、如果 wsl --install 报错

情况1:手动启用 Windows 功能

如果一键安装失败,手动开启:

方法一(图形界面):

  1. Win + R→ 输入optionalfeatures
  2. 勾选这两项:
    • ✅ 适用于 Linux 的 Windows 子系统
    • ✅ 虚拟机平台
  3. 确定 → 重启

方法二(命令行):

# 管理员 PowerShell 运行dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重启电脑。

情况2:下载 WSL2 内核更新包

如果提示需要更新内核,手动下载安装:

下载地址:https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

双击安装 → 重启。

情况3:旧版 Windows 不支持

WSL2 需要 Windows 10 1903 或更高版本。查看版本:

winver

如果版本太旧,先更新 Windows。


六、第四步:配置 Docker Desktop 使用 WSL2

6.1 设置后端

安装好 Docker Desktop 后:

  1. 打开 Docker Desktop
  2. 设置 → General
  3. 确保勾选:Use the WSL 2 based engine
  4. Apply & Restart

6.2 分配资源(可选)

设置 → Resources → WSL Integration

可以给 Docker 分配的 CPU 和内存。一般保持默认就行,如果跑大项目可以调大内存。

6.3 验证 Docker 正常工作

dockerrun hello-world

看到Hello from Docker!说明一切就绪 ✅


七、常见问题

Q1:BIOS 里找不到虚拟化选项

可能原因:

  • CPU 不支持虚拟化(很罕见,近10年的CPU基本都支持)
  • BIOS 被锁定(部分企业采购的电脑)

检查 CPU 是否支持:

systeminfo|findstr"虚拟"

Q2:WSL2 安装后 Ubuntu 打不开

# 重置 WSLwsl--shutdownwsl--update

Q3:Docker 启动很慢

正常现象,WSL2 首次启动需要初始化。后续启动会快很多。

Q4:笔记本关闭虚拟化省电

部分笔记本出厂关闭虚拟化以省电。进 BIOS 开启后注意:虚拟化会增加约 2-3% 的待机功耗,对日常使用基本无影响。


八、总结

步骤操作验证方式
1. 开启硬件虚拟化BIOS → VT-x / SVM = Enabled任务管理器显示「已启用」
2. 启用 Windows 功能勾选 WSL + 虚拟机平台功能列表显示已勾选
3. 安装 WSL2wsl --installwsl -l -v显示 VERSION 2
4. 配置 DockerDocker 设置 WSL2 引擎docker run hello-world成功

核心就一句话:BIOS 开虚拟化 → Windows 开 WSL 功能 → 安装 WSL2 → Docker 就能正常跑了。


作者的话:本文覆盖了 Windows 环境下 Docker 安装的所有前置条件。有问题评论区交流!

觉得有帮助点个赞👍


本文为原创内容,转载请注明出处。

📌 相关推荐:Docker 部署前后端分离项目完整教程

返回列表