WSL之旅 - 疑难解答

1. 安装失败并出现错误 0x80070003

适用于 Linux 的 Windows 子系统只能在系统驱动器（通常是 C: 驱动器）中运行。请确保分发版存储在系统驱动器上：打开“设置”->“系统”-->“存储”-> “更多存储设置”： 更改新内容的保存位置”

2. WslRegisterDistribution 失败并出现错误 0x8007019e

未启用“适用于 Linux 的 Windows 子系统”可选组件：

打开“控制面板” -> “程序和功能” -> “打开或关闭 Windows 功能”-> 选中“适用于 Linux 的 Windows 子系统”，或使用本文开头所述的 PowerShell cmdlet。

3. 安装失败，出现错误 0x80070003 或错误 0x80370102

请确保在计算机的 BIOS 内已启用虚拟化。有关如何执行此操作的说明因计算机而异，并且很可能在 CPU 相关选项下。WSL2 要求 CPU 支持二级地址转换 (SLAT) 功能，后者已在 Intel Nehalem 处理器（Intel Core 第一代）和 AMD Opteron 中引入。即使成功安装了虚拟机平台，旧版 CPU（例如 Intel Core 2 Duo）也无法运行 WSL2。

4. 尝试升级时出错：Invalid command line option: wsl --set-version Ubuntu 2

请确保已启用适用于 Linux 的 Windows 子系统，并且你使用的是 Windows 内部版本 18362 或更高版本。若要启用 WSL，请在 PowerShell 提示符下以具有管理员权限的身份运行此命令：Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux。

5. 由于虚拟磁盘系统的某个限制，无法完成所请求的操作。虚拟硬盘文件必须是解压缩的且未加密的，并且不能是稀疏的

取消选中“压缩内容”（如果已选中“加密内容”，请一并取消选中），方法是打开 Linux 发行版的配置文件文件夹。它应位于 Windows 文件系统上的一个文件夹中，类似于：USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited...
在此 Linux 发行版配置文件中，应存在一个 LocalState 文件夹。右键单击此文件夹可显示选项的菜单。选择“属性”>“高级”，然后确保未选择（未勾选）“压缩内容以节省磁盘空间”和“加密内容以保护数据”复选框。如果系统询问是要将此应用到当前文件夹还是应用到所有子文件夹和文件，请选择“仅此文件夹”，因为你只是要清除压缩标志。完成此操作后，wsl --set-version 命令应正常工作。

6. 无法将词语“wsl”识别为 cmdlet、函数、脚本文件或可运行程序的名称

请确保已安装“适用于 Linux 的 Windows 子系统”可选组件。此外，如果你使用的是 ARM64 设备，并从 PowerShell 运行此命令，则会收到此错误。请改为从 PowerShell Core 或从命令提示符运行 wsl.exe。

7. 错误：此更新仅适用于装有适用于 Linux 的 Windows 子系统的计算机

若要安装 Linux 内核更新 MSI 包，需要 WSL，应先启用它。如果失败，将看到以下消息：This update only applies to machines with the Windows Subsystem for Linux。
出现此消息有三个可能的原因：

你仍使用旧版 Windows，不支持 WSL 2。有关版本要求和要更新的链接，请参阅步骤 #2。
未启用 WSL。需要返回到步骤 #1，并确保在计算机上启用了可选的 WSL 功能。
启用 WSL 后，需要重新启动才能使其生效，请重新启动计算机，然后重试。

8. 错误：WSL 2 要求对其内核组件进行更新

如果 %SystemRoot%\system32\lxss\tools 文件夹中缺少 Linux 内核包，会遇到此错误。若要解决此问题，请在安装说明的步骤 #4 中安装 Linux 内核更新 MSI 包。可能会需要从添加或删除程序卸载 MSI，然后重新安装。

9. 忘记 WSL 密码

如果忘记了 Linux 分发版的密码：

请打开 PowerShell，并使用以下命令进入默认 WSL 分发版的根目录：wsl -u root

如果需要在非默认分发版中更新忘记的密码，请使用命令：wsl -d Debian -u root，并将 Debian 替换为目标分发版的名称。

在 PowerShell 内的根级别打开 WSL 发行版后，可使用此命令更新密码：passwd ，其中是 DISTRO 中帐户的用户名，而你忘记了它的密码。
系统将提示你输入新的 UNIX 密码，然后确认该密码。在被告知密码已成功更新后，请使用以下命令在 PowerShell 内关闭 WSL：exit

张维龙博客

WSL之旅 – 疑难解答