无尘阁日记

无尘阁日记

wsl --install 在windows10 版本22H2(操作系统内部版本19045.4291)上执行,直接显示命令帮助的条目、信息,并不执行为啥?
2026-05-02

你这个现象不是你输入错了。在 Windows 10 22H2,wsl --install 只显示帮助、不真正安装,最常见原因是:

核心原因

你的系统版本 19045.4291 是支持 WSL2 的。微软要求 Windows 10 版本 2004 以上、Build 19041 以上即可使用 wsl --install,你已经满足。(Microsoft Learn)

但微软文档里也特别说明:如果运行 wsl --install 只看到帮助文本,需要先列出发行版,再明确指定发行版安装,也就是用:

wsl --list --online

然后再执行:

wsl --install -d Ubuntu

微软也提到,在 Windows 10 或较老环境里,可能必须带 -d 参数指定发行版。(Microsoft Learn)


你直接按这个顺序执行

1. 以管理员身份打开 PowerShell

开始菜单搜索:

PowerShell

右键:

以管理员身份运行

2. 先查看可安装发行版

wsl --list --online

或者简写:

wsl -l -o

如果能看到 Ubuntu、Debian、Kali 等列表,说明 WSL 命令本身可用。


3. 明确指定 Ubuntu 安装

优先执行这个:

wsl --install -d Ubuntu

如果还是不动,或者下载卡住,再执行这个:

wsl --install --web-download -d Ubuntu

--web-download 的意思是:不用 Microsoft Store,改用在线源下载安装。微软文档里也专门建议卡住时用这个参数。(Microsoft Learn)


如果还是只显示帮助,执行完整修复版

1. 手动启用 WSL 功能

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

2. 启用虚拟机平台

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

这两个是 WSL2 必需的 Windows 功能,微软手动安装文档也是这样要求的。(Microsoft Learn)

3. 确保虚拟化启动

bcdedit /set hypervisorlaunchtype auto

4. 重启电脑

shutdown /r /t 0

5. 重启后设置默认 WSL2

wsl --set-default-version 2

6. 再安装 Ubuntu

wsl --install -d Ubuntu

或者:

wsl --install --web-download -d Ubuntu

再检查一下你的 WSL 状态

wsl --status
wsl --version
wsl -l -v

如果安装成功,wsl -l -v 应该能看到类似:

NAME      STATE           VERSION
Ubuntu    Stopped         2

结论

你现在的问题大概率是:

Windows 10 上的 wsl --install 裸命令没有触发默认安装,需要指定发行版。

所以你先不要纠结,直接用这个:

wsl --install -d Ubuntu

如果网络或商店源有问题,就用:

wsl --install --web-download -d Ubuntu

这两条是你当前情况最该先试的。