Windows 开启虚拟化 + WSL2 完整安装指南(Docker 前置条件)
Windows 开启虚拟化 + WSL2 完整安装指南(Docker 前置条件)
很多新手安装 Docker Desktop 时报错"未检测到虚拟化支持",根本原因是没有开启 BIOS 虚拟化和 WSL2。本文手把手教你从零开启。
适用人群:Windows 用户、Docker 新手、安装 Docker 报错的开发者
测试环境:Windows 10/11,支持 Intel 和 AMD 处理器
一、为什么要开启虚拟化?
Docker Desktop 在 Windows 上依赖两个底层技术:
- 硬件虚拟化(VT-x / AMD-V)— BIOS 级别,CPU 必须支持
- 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 界面语言 |
|---|---|---|
| 联想 ThinkPad | F1 | 英文 |
| 戴尔 Dell | F2 | 英文 |
| 惠普 HP | F10 | 英文 |
| 华硕 ASUS | F2或Del | 英文/中文 |
| 微星 MSI | Del | 英文/中文 |
| 组装机 | Del或F2 | 看主板品牌 |
3.2 找到虚拟化选项
Intel CPU 找:
Security → Virtualization → Intel Virtualization Technology (VT-x) 改为:Enabled有些 BIOS 的路径不同,也可能叫:
CPU Configuration → Intel Virtualization TechnologyAdvanced → CPU Setup → Virtualization
AMD CPU 找:
Advanced → CPU Configuration → SVM Mode 改为:Enabled3.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-version24.4 验证 WSL2
wsl-l-v输出示例:
NAME STATE VERSION * Ubuntu Running 2 ← VERSION 必须是 2如果 VERSION 显示 1,手动转换:
wsl --set-version Ubuntu2五、如果 wsl --install 报错
情况1:手动启用 Windows 功能
如果一键安装失败,手动开启:
方法一(图形界面):
- 按
Win + R→ 输入optionalfeatures - 勾选这两项:
- ✅ 适用于 Linux 的 Windows 子系统
- ✅ 虚拟机平台
- 确定 → 重启
方法二(命令行):
# 管理员 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 后:
- 打开 Docker Desktop
- 设置 → General
- 确保勾选:
Use the WSL 2 based engine - 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--updateQ3:Docker 启动很慢
正常现象,WSL2 首次启动需要初始化。后续启动会快很多。
Q4:笔记本关闭虚拟化省电
部分笔记本出厂关闭虚拟化以省电。进 BIOS 开启后注意:虚拟化会增加约 2-3% 的待机功耗,对日常使用基本无影响。
八、总结
| 步骤 | 操作 | 验证方式 |
|---|---|---|
| 1. 开启硬件虚拟化 | BIOS → VT-x / SVM = Enabled | 任务管理器显示「已启用」 |
| 2. 启用 Windows 功能 | 勾选 WSL + 虚拟机平台 | 功能列表显示已勾选 |
| 3. 安装 WSL2 | wsl --install | wsl -l -v显示 VERSION 2 |
| 4. 配置 Docker | Docker 设置 WSL2 引擎 | docker run hello-world成功 |
核心就一句话:BIOS 开虚拟化 → Windows 开 WSL 功能 → 安装 WSL2 → Docker 就能正常跑了。
作者的话:本文覆盖了 Windows 环境下 Docker 安装的所有前置条件。有问题评论区交流!
觉得有帮助点个赞👍
本文为原创内容,转载请注明出处。
📌 相关推荐:Docker 部署前后端分离项目完整教程
