帮助中心 Logo
帮助中心 Logo
  1. 首页
  2. docker
  3. WSL2/Windows 系统兼容性快速判断流程

WSL2/Windows 系统兼容性快速判断流程

  • docker
  • 发布于 2026-10-14
  • 3 次阅读
Administrator Administrator 已删除用户 已删除用户

WSL 无法运行

│

├─ 1. Windows 版本是否支持?

│ └─ Windows 10 2004(Build 19041)及以上,或 Windows 11

│

├─ 2. 两项可选功能是否均为 Enabled?

│ ├─ 否 → 启用功能、重启后复查

│ └─ 是 → 继续

│

├─ 3. wsl --status 是否仍报 OPTIONAL_COMPONENT_REQUIRED?

│ ├─ 是 → 检查功能是否在重启后回退为 Disabled

│ └─ 否 → 继续安装/启动发行版

│

├─ 4. 功能是否“启用成功但重启后自动禁用”?

│ ├─ 是 → Windows 组件注册/服务堆栈异常,需就地修复安装

│ └─ 否 → 检查 BIOS 虚拟化、Hyper-V 与具体错误码

│

└─ 5. 仅在功能已正常启用后,才排查 Ubuntu/发行版问题

一次性检查命令

以管理员 PowerShell 执行:

winver

Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux |

Select-Object FeatureName,State,RestartNeeded

Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform |

Select-Object FeatureName,State,RestartNeeded

wsl --status

sc.exe query WslService

sc.exe query vmcompute

结果判断

现象

判断

优先处理

Windows 10 低于 Build 19041

系统版本不支持 WSL2

更新 Windows

两项功能任一为 Disabled

WSL2 前置组件未生效

启用功能并重启

wsl --status 报 WSL_E_WSL_OPTIONAL_COMPONENT_REQUIRED

Windows 未向 WSL 提供所需组件

先查两项功能状态

功能显示 Enabled,重启后变回 Disabled

Windows 可选功能注册/组件存储异常

DISM + SFC;仍失败则就地修复安装

WslService 退出码 1058,且 vmcompute 不存在

功能被禁用导致服务无法加载

不要重装 Ubuntu,先修 Windows 组件

报 0x80370102

通常是 CPU 虚拟化或虚拟机平台问题

检查 BIOS 的 VT-x/AMD-V 与虚拟机平台

两项功能均 Enabled,wsl --status 正常

Windows 兼容层正常

再安装/修复发行版

标准修复顺序

DISM.exe /Online /Cleanup-Image /RestoreHealth

sfc /scannow

重启后,启用功能:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

再次重启,并重新查询两项功能状态。只有两项都稳定显示 Enabled,才继续:

wsl --update

wsl --set-default-version 2

wsl --install -d Ubuntu

何时直接判定为 Windows 系统兼容性异常

满足以下任一情况,就不要反复重装 WSL、Ubuntu 或重启:

  • DISM 显示“操作成功”,但立即查询仍是 Disabled;

  • 图形界面已勾选 WSL 和“虚拟机平台”,命令行仍持续显示禁用;

  • 重启后两项功能自动回退为 Disabled;

  • 已成功执行 DISM /RestoreHealth 与 sfc /scannow,问题不变;

  • WslService 被禁用、vmcompute 缺失,同时两项功能处于禁用状态。

这类情况应检查企业策略、系统优化/精简工具;若无明确管理策略,采用 Windows 就地修复安装,并选择“保留个人文件和应用”。这是微软 WSL 排障文档建议的后续路径。 WSL 官方排障 Windows 就地修复安装说明

目录
Copyright©2025 Fanxiang.com 版权所有 粤ICP备19097444号