ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

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

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 必须支持WSL2Windows 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 或 CMDsysteminfo找到「Hyper-V 要求」部分Hyper-V 要求: 已检测到虚拟机监视器模式扩展: 是 固件中已启用虚拟化: 是 ← 这里显示「是」说明已开启如果显示「否」说明需要进 BIOS 开启。三、第二步BIOS 开启虚拟化3.1 各品牌进 BIOS 的按键品牌开机按哪个键BIOS 界面语言联想 ThinkPadF1英文戴尔 DellF2英文惠普 HPF10英文华硕 ASUSF2或Del英文/中文微星 MSIDel英文/中文组装机Del或F2看主板品牌3.2 找到虚拟化选项Intel CPU 找Security → Virtualization → Intel Virtualization Technology (VT-x) 改为Enabled有些 BIOS 的路径不同也可能叫CPU Configuration → Intel Virtualization TechnologyAdvanced → CPU Setup → VirtualizationAMD CPU 找Advanced → CPU Configuration → SVM Mode 改为Enabled3.3 保存重启按F10保存并退出Save and Exit。3.4 验证重启后再次打开任务管理器 → 性能 → CPU → 虚拟化显示「已启用」✅四、第三步安装 WSL24.1 一键安装Windows 10 2004 或 Windows 11以管理员身份打开 PowerShell运行wsl--install这个命令会自动完成启用「适用于 Linux 的 Windows 子系统」功能启用「虚拟机平台」功能下载并安装 WSL2 内核安装 Ubuntu默认发行版4.2 重启电脑安装完成后必须重启才能生效。4.3 设置 WSL2 为默认版本重启后再次打开 PowerShellwsl --set-default-version24.4 验证 WSL2wsl-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 使用 WSL26.1 设置后端安装好 Docker Desktop 后打开 Docker Desktop设置 → General确保勾选Use the WSL 2 based engineApply Restart6.2 分配资源可选设置 → Resources → WSL Integration可以给 Docker 分配的 CPU 和内存。一般保持默认就行如果跑大项目可以调大内存。6.3 验证 Docker 正常工作dockerrun hello-world看到Hello from Docker!说明一切就绪 ✅七、常见问题Q1BIOS 里找不到虚拟化选项可能原因CPU 不支持虚拟化很罕见近10年的CPU基本都支持BIOS 被锁定部分企业采购的电脑检查 CPU 是否支持systeminfo|findstr虚拟Q2WSL2 安装后 Ubuntu 打不开# 重置 WSLwsl--shutdownwsl--updateQ3Docker 启动很慢正常现象WSL2 首次启动需要初始化。后续启动会快很多。Q4笔记本关闭虚拟化省电部分笔记本出厂关闭虚拟化以省电。进 BIOS 开启后注意虚拟化会增加约 2-3% 的待机功耗对日常使用基本无影响。八、总结步骤操作验证方式1. 开启硬件虚拟化BIOS → VT-x / SVM Enabled任务管理器显示「已启用」2. 启用 Windows 功能勾选 WSL 虚拟机平台功能列表显示已勾选3. 安装 WSL2wsl --installwsl -l -v显示 VERSION 24. 配置 DockerDocker 设置 WSL2 引擎docker run hello-world成功核心就一句话BIOS 开虚拟化 → Windows 开 WSL 功能 → 安装 WSL2 → Docker 就能正常跑了。作者的话本文覆盖了 Windows 环境下 Docker 安装的所有前置条件。有问题评论区交流觉得有帮助点个赞本文为原创内容转载请注明出处。 相关推荐Docker 部署前后端分离项目完整教程
返回列表