WSL安装失败需按五步排查：一、确认系统版本≥Win10 2004并启用子系统与虚拟机平台功能；二、用wsl --install --web-download绕过应用商店；三、手动下载安装WSL内核更新包；四、卸载残留发行版并重置功能；五、在BIOS中开启CPU虚拟化支持。
如果您尝试在Windows系统中安装WSL（适用于Linux的Windows子系统），但安装过程失败并出现错误提示，则可能是由于系统版本不兼容、关键功能未启用、网络限制或组件损坏所致。以下是解决此问题的步骤：
一、确认系统版本与启用必要功能
WSL 2要求Windows 10版本2004（Build 19041）或更高版本，或Windows 11全版本。若系统版本过低，或“适用于Linux的Windows子系统”“虚拟机平台”两项功能未启用，将直接导致安装失败。
1、按下 Win + R，输入 winver 回车，查看当前系统版本号。
2、若版本低于Build 19041，打开“设置 > 更新与安全 > Windows更新”，检查并安装所有可用更新，重启后重试。
3、以管理员身份运行PowerShell，依次执行以下两条命令：
4、dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
5、dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
6、执行完毕后，必须重启计算机，使更改生效。
二、强制使用Web下载方式安装
默认安装依赖Windows应用商店服务，若该服务异常或被代理/防火墙拦截，会导致“E_UNEXPECTED”“0x80070660”等错误。通过 --web-download 参数可绕过商店，直连微软官方服务器下载内核与发行版。
1、以管理员身份打开PowerShell或Windows终端。
2、输入完整命令：wsl --install --web-download -d Ubuntu-24.04
3、若需指定其他发行版，可将 Ubuntu-24.04 替换为 Debian 或 openSUSE-Leap 等名称。
三、手动安装WSL内核更新包
自动安装失败时，常因内核更新包（Linux kernel update package）下载中断或校验失败。微软提供独立MSI安装包，可离线验证并安装，规避网络波动影响。
1、访问微软官方WSL内核更新页面：https://aka.ms/wsl2kernel
2、下载最新版 wsl_update_x64.msi 文件（截至2026年3月，最新为2.6.1.0）。
Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...
3、双击运行该MSI文件，按向导完成安装。
4、安装完成后，在PowerShell中运行：wsl --set-default-version 2
四、重置WSL环境并清理残留组件
当多次安装失败后，系统可能残留损坏的注册表项、缓存分发版或冲突的HCS（Host Compute Service）配置。彻底卸载并重建可排除此类深层异常。
1、列出已注册发行版：wsl -l -v
2、对每个已列出的发行版（如Ubuntu），执行：wsl --unregister Ubuntu
3、关闭WSL子系统：wsl --shutdown
4、禁用两项核心功能：dism.exe /online /disable-feature /featurename:Microsoft-Windows-Subsystem-Linux
5、dism.exe /online /disable-feature /featurename:VirtualMachinePlatform
6、重启电脑。
7、重启后，以管理员身份运行PowerShell，重新启用两项功能并设置默认版本为2。
五、排查BIOS级虚拟化支持
即使Windows中启用了“虚拟机平台”，若CPU虚拟化技术（Intel VT-x 或 AMD-V）在固件层被禁用，WSL 2仍将无法启动，并报错 HCS_E_HYPERV_NOT_INSTALLED 或类似服务未安装提示。
1、重启电脑，在开机自检阶段反复按 F2、Delete、F12 或 Esc（依主板品牌而异）进入BIOS/UEFI设置界面。
2、导航至 Advanced > CPU Configuration 或 Security > Virtualization 类似路径。
3、将 Intel Virtualization Technology 或 SVM Mode 设置为 Enabled。
4、保存设置并退出（通常为F10），系统重启后再次尝试安装。
