排查适用于 Linux 的 Windows 子系统问题

项目
03/24/2023

我们在下面介绍了一些与 WSL 相关的常见故障排除场景，但也请考虑在 GitHub 上的 WSL 产品存储库中搜索已提交的问题。

提交问题、bug 报告、功能请求

借助 WSL 产品存储库问题，可进行以下操作：

搜索现有问题，查看是否存在任何与遇到的问题相关的问题。请注意，在搜索栏中可以删除“is:open”，以便在搜索中包括已解决的问题。请考虑对任何希望优先处理的未解决问题发表评论或点赞。
提交新问题。如果发现 WSL 存在问题，并且该问题不像是已有的问题，你可以选择绿色的“新问题”按钮，然后选择“WSL - Bug 报告” 。需要在其中提供以下信息：问题的标题、Windows 内部版本号（运行 cmd.exe /c ver 查看当前的内部版本号）、运行的是 WSL 1 还是 2、当前的 Linux 内核版本号（运行 wsl.exe --status 或 cat /proc/version）、发行版的版本号（运行 lsb_release -r）、涉及的任何其他软件版本、重现步骤、预期行为、实际行为和诊断日志（如果可用且适当）。有关详细信息，请参阅参与 WSL 工作。
提交功能请求，方法是选择绿色的“新问题”按钮，然后选择“功能请求” 。需要回答几个描述你的请求的问题。

也可执行以下操作：

使用 WSL 文档存储库提交文档问题。若要参与编写 WSL 文档，请参阅 Microsoft Docs 参与者指南。
如果问题更多地与 Windows 终端、Windows 控制台或命令行 UI 相关，请使用 Windows 终端产品存储库提交 Windows 终端问题。

安装问题

安装失败并出现错误 0x80070003
- 适用于 Linux 的 Windows 子系统只能在系统驱动器（通常是 C: 驱动器）中运行。请确保分发版存储在系统驱动器上：
- 在 Windows 10 上打开“设置”->“系统”->“存储”->“更多存储设置: 更改新内容的保存位置”
- 在 Windows 11 上打开“设置”->“系统”->“存储”->“高级存储设置”->“新内容的保存位置”
WslRegisterDistribution 失败并出现错误 0x8007019e
- 未启用“适用于 Linux 的 Windows 子系统”可选组件：
- 打开“控制面板”->“程序和功能”->“打开或关闭 Windows 功能”-> 选中“适用于 Linux 的 Windows 子系统”，或使用本文开头所述的 PowerShell cmdlet。
安装失败，出现错误 0x80070003 或错误 0x80370102
- 请确保在计算机的 BIOS 内已启用虚拟化。有关如何执行此操作的说明因计算机而异，并且很可能在 CPU 相关选项下。
- WSL2 要求 CPU 支持二级地址转换 (SLAT) 功能，后者已在 Intel Nehalem 处理器（Intel Core 第一代）和 AMD Opteron 中引入。即使成功安装了虚拟机平台，旧版 CPU（例如 Intel Core 2 Duo）也无法运行 WSL2。
尝试升级时出错：Invalid command line option: wsl --set-version Ubuntu 2
- 请确保已启用适用于 Linux 的 Windows 子系统，并且你使用的是 Windows 内部版本 18362 或更高版本。若要启用 WSL，请在 PowerShell 提示符下以具有管理员权限的身份运行此命令：Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux。
由于虚拟磁盘系统的某个限制，无法完成所请求的操作。虚拟硬盘文件必须是解压缩的且未加密的，并且不能是稀疏的。
- 取消选中“压缩内容”（如果已选中“加密内容”，请一并取消选中），方法是打开 Linux 发行版的配置文件文件夹。它应位于 Windows 文件系统上的一个文件夹中，类似于：%USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited...
- 在此 Linux 发行版配置文件中，应存在一个 LocalState 文件夹。右键单击此文件夹可显示选项的菜单。选择“属性”>“高级”，然后确保未选择（未勾选）“压缩内容以节省磁盘空间”和“加密内容以保护数据”复选框。如果系统询问是要将此应用到当前文件夹还是应用到所有子文件夹和文件，请选择“仅此文件夹”，因为你只是要清除压缩标志。完成此操作后，wsl --set-version 命令应正常工作。

WSL 发行版属性设置的屏幕截图

注意

在我的示例中，我的 Ubuntu 18.04 发行版的 LocalState 文件夹位于 C:\Users<my-user-name>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc

请检查 WSL Docs GitHub 主题 #4103，其中跟踪了此问题以提供更新的信息。

无法将词语“wsl”识别为 cmdlet、函数、脚本文件或可运行程序的名称。
- 请确保已安装“适用于 Linux 的 Windows 子系统”可选组件。此外，如果你使用的是 ARM64 设备，并从 PowerShell 运行此命令，则会收到此错误。请改为从 PowerShell Core 或从命令提示符运行 wsl.exe。
错误：适用于 Linux 的 Windows 子系统未安装发行版。
- 如果你在已安装 WSL 发行版之后收到此错误：
1. 请先运行该发行版一次，然后在从命令行中调用它。
2. 检查你是否正在运行单独的用户帐户。运行具有提升权限（在管理员模式下）的主要用户帐户应该不会导致出现此错误，但你应确保你未在无意中运行 Windows 附带的内置管理员帐户。这是单独的用户帐户，根据设计将不显示任何已安装的 WSL 发行版。有关详细信息，请参阅启用和禁用内置 Administrator 帐户。
3. WSL 可执行文件仅安装到本机系统目录中。在 64 位 Windows 上运行 32 位进程（若在 ARM64 上，则为任何非本机组合）时，托管的非本机进程实际上会看到一个不同的 System32 文件夹。（32 位进程在 x64 Windows 上看到的文件夹存储在 \Windows\SysWOW64 处的磁盘上。）你可通过查看虚拟文件夹 \Windows\sysnative，访问来自托管进程的“本机”system32 文件夹。请记住，它实际上不会存在于磁盘上，不过文件系统路径解析程序会找到它。
错误：此更新仅适用于装有适用于 Linux 的 Windows 子系统的计算机。
- 若要安装 Linux 内核更新 MSI 包，需要 WSL，应先启用它。如果失败，将看到以下消息：This update only applies to machines with the Windows Subsystem for Linux。
- 出现此消息有三个可能的原因：
1. 你仍使用旧版 Windows，不支持 WSL 2。有关版本要求和要更新的链接，请参阅步骤 #2。
2. 未启用 WSL。需要返回到步骤 #1，并确保在计算机上启用了可选的 WSL 功能。
3. 启用 WSL 后，需要重新启动才能使其生效，请重新启动计算机，然后重试。
错误： WSL 2 要求对其内核组件进行更新。若需了解相关信息，请访问 https://aka.ms/wsl2kernel。
- 如果 %SystemRoot%\system32\lxss\tools 文件夹中缺少 Linux 内核包，会遇到此错误。若要解决此问题，请在安装说明的步骤 #4 中安装 Linux 内核更新 MSI 包。可能会需要从“添加或删除程序”卸载 MSI，然后重新安装。

常见问题

我在使用 Windows 10 版本 1903，但我还是没看见 WSL 2 选项

这可能是因为你的计算机尚未实现对 WSL 2 的向后移植。要解决此问题，最简单的方法是转到 Windows 设置，然后打击“检查更新”，在你的系统上安装最新更新。查看有关实现向后移植的完整说明。

如果你点击了“检查更新”，但仍未收到更新，可以手动安装 KB KB4566116。

错误：使用 `wsl --set-default-version 2` 时显示 0x1bc

当“显示语言”或“系统区域设置”未设为英语时，可能会发生此情况。

wsl --set-default-version 2
Error: 0x1bc
For information on key differences with WSL 2 please visit https://aka.ms/wsl2

0x1bc 的实际错误为：

WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel

有关详细信息，请查看问题 5749

无法从 Windows 访问 WSL 文件

9p 协议文件服务器在 Linux 端提供服务，以允许 Windows 访问 Linux 文件系统。如果在 Windows 上无法使用 \\wsl$ 访问 WSL，则可能是因为 9P 无法正确启动。

要检查这一点，可以使用 dmesg |grep 9p 来检查启动日志，这将显示任何错误。成功的输出如下所示：

[    0.363323] 9p: Installing v9fs 9p2000 file system support
[    0.363336] FS-Cache: Netfs '9p' registered for caching
[    0.398989] 9pnet: Installing 9P2000 support

请参阅此 GitHub 主题获取有关此问题的进一步讨论。

无法启动 WSL 2 发行版，仅在输出中看到“WSL 2”

如果你的显示语言不是英语，则可能会看到截断的错误文本。

C:\Users\me>wsl
WSL 2

要解决此问题，请访问 https://aka.ms/wsl2kernel，按照该文档页面上的指示手动安装内核。

在 linux 中执行 windows .exe 时，`command not found`

用户可以直接从 Linux 运行 notepad.exe 等 Windows 可执行文件。有时，你可能会点击“找不到命令”，如下所示：

$ notepad.exe
-bash: notepad.exe: command not found

如果 $PATH 中没有 win32 路径，互操作将找不到 .exe。可以通过在 Linux 中运行 echo $PATH 来进行验证。应会在输出中看到 win32 路径（例如，/mnt/c/Windows）。如果看不到任何 Windows 路径，则很可能是 Linux shell 覆盖了 PATH。

以下是 Debian 上的 /etc/profile 导致此问题的一个示例：

if [ "`id -u`" -eq 0 ]; then
  PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
else
  PATH="/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games"
fi

Debian 上的正确方法是删除以上行。还可在赋值过程中追加 $PATH（如下所示），但这可能导致 WSL 和 VSCode 的一些其他问题。

if [ "`id -u`" -eq 0 ]; then
  PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:$PATH"
else
  PATH="/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games:$PATH"
fi

有关详细信息，请参阅问题 5296 和问题 5779。

Windows 更新后出现“错误:0x80370102 由于未安装所需功能，因此无法启动虚拟机。”

请启用 Virtual Machine Platform Windows 功能，并确保在 BIOS 中启用了虚拟化。

请查看 Hyper-V 系统要求
如果你的计算机是 VM，请手动启用嵌套虚拟化。使用 admin 启动 powershell，并运行：
```
Set-VMProcessor -VMName <VMName> -ExposeVirtualizationExtensions $true
```
请按照电脑制造商提供的虚拟化启用指南进行操作。通常，这可能涉及使用系统 BIOS 来确保在 CPU 上启用了这些功能。此过程的说明可能因计算机而异，有关示例，请参阅来自 Bleeping Computer 的本文。
启用 Virtual Machine Platform 可选组件后，请重启计算机。
确保在启动配置中启用了虚拟机监控程序启动。可以通过运行（提升的 PowerShell）来对此进行验证：
```
 bcdedit /enum | findstr -i hypervisorlaunchtype
```
如果看到 hypervisorlaunchtype Off，则会禁用虚拟机监控程序。使其在提升的 PowerShell 中运行：
```
 bcdedit /set hypervisorlaunchtype Auto
```
此外，如果安装了第三方虚拟机监控程序（例如 VMware 或 VirtualBox），请确保安装其最新版本（VMware 15.5.5+ 和 VirtualBox 6+这些版本可以支持 HyperV）或关闭它们。

详细了解在虚拟机中运行 Hyper-V 时如何配置嵌套虚拟化。

WSL 在工作计算机上或在企业环境中没有网络连接

业务或企业环境可能已将 Windows Defender防火墙设置配置为阻止未经授权的网络流量。如果本地规则合并设置为“否”，则 WSL 网络在默认情况下无效，并且管理员需要添加防火墙规则以允许它。

可以按照以下步骤确认本地规则合并的设置：

Windows 防火墙设置屏幕截图

打开“高级安全 Windows Defender 防火墙”（这不是“控制面板”中的“Windows Defender 防火墙”）
右键单击“本地计算机上的高级安全 Windows Defender 防火墙”选项卡
选择“属性”
在打开的新窗口中选择“公共配置文件”选项卡
在“设置”部分下选择“自定义”
在打开的“自定义公共配置文件的设置”窗口中查看“规则合并”是否设置为“否”。这将阻止对 WSL 的访问。

可在企业环境：为公司设置 WSL 中找到有关如何更改此项防火墙设置的说明。

WSL 在连接到 VPN 后没有网络连接

如果在连接到 Windows 上的 VPN 后 bash 断开网络连接，请尝试从 bash 内部解决问题。此解决方法允许通过 /etc/resolv.conf 手动替代 DNS 解析。

执行 ipconfig.exe /all，记下 VPN 的 DNS 服务器
执行 sudo cp /etc/resolv.conf /etc/resolv.conf.new，创建现有 resolv.conf 的副本
执行 sudo unlink /etc/resolv.conf 以便与当前 resolv.conf 取消链接
sudo mv /etc/resolv.conf.new /etc/resolv.conf
编辑 /etc/wsl.conf 并将此内容添加到文件。（有关此设置的详细信息，请参阅高级设置配置）

[network]
generateResolvConf=false

打开 /etc/resolv.conf 并执行以下操作
a. 从文件中删除第一行，其中包含描述自动生成的注释
b. 将上面步骤 (1) 中记下的 DNS 条目添加为 DNS 服务器列表中的第一个条目。
c. 关闭该文件。

断开 VPN 连接后，必须将更改还原为 /etc/resolv.conf。为此，请执行以下命令：

cd /etc
sudo mv resolv.conf resolv.conf.new
sudo ln -s ../run/resolvconf/resolv.conf resolv.conf

启动 WSL 或安装分发版会返回一个错误代码

按照这些说明收集详细日志并在 GitHub 上提出问题。

更新 WSL

适用于 Linux 的 Windows 子系统有两个组件需要更新。

若要更新适用于 Linux 的 Windows 子系统本身，请在 PowerShell 或 CMD 中使用命令 wsl --update。
若要更新特定的 Linux 发行版用户二进制文件，请在要更新的 Linux 发行版中使用命令：apt-get update | apt-get upgrade。

Apt-get upgrade 错误

某些包使用我们尚未实现的功能。例如，udev 尚不受支持，会导致多个 apt-get upgrade 错误。

若要解决与 udev 相关的问题，请执行以下步骤：

将以下内容写入 /usr/sbin/policy-rc.d 并保存更改。
```
#!/bin/sh
exit 101
```
将执行权限添加到 /usr/sbin/policy-rc.d：
```
chmod +x /usr/sbin/policy-rc.d
```

运行以下命令：

dpkg-divert --local --rename --add /sbin/initctl
ln -s /bin/true /sbin/initctl

Windows 更新后出现“错误:0x80040306”

此错误与我们不支持旧版控制台这一事实有关。若要关闭旧版控制台：

打开 cmd.exe
右键单击标题栏 -> 选择“属性”-> 取消选中“使用旧版控制台”
单击“确定”

Windows 更新后出现“错误:0x80040154”

在 Windows 更新期间可能禁用了“适用于 Linux 的 Windows 子系统”功能。如果出现这种情况，则必须重新启用 Windows 功能。在手动安装指南中可以找到有关启用“适用于 Linux 的 Windows 子系统”的说明。

更改显示语言

WSL 安装会尝试自动更改 Ubuntu 区域设置，使之与 Windows 安装的区域设置相匹配。如果你不希望出现此行为，可以在安装完成后，运行此命令来更改 Ubuntu 区域设置。必须重新启动 bash.exe 才能使此项更改生效。

以下示例将区域设置更改为 en-US：

sudo update-locale LANG=en_US.UTF8

Windows 系统还原后出现的安装问题

删除 %windir%\System32\Tasks\Microsoft\Windows\Windows Subsystem for Linux 文件夹。
注意：如果可选功能已完全安装且工作正常，请不要执行此操作。
启用 WSL 可选功能（如果尚未这样做）
重新启动
lxrun /uninstall /full
安装 bash

在 WSL 中无法进行 Internet 访问

某些用户已报告特定的防火墙应用程序会阻止 WSL 中的 Internet 访问的问题。报告的防火墙包括：

Kaspersky
AVG
Avast
Symantec Endpoint Protection

在某些情况下，关闭防火墙即可进行访问。在某些情况下，只需让安装的防火墙在表面上阻止访问。

如果使用的是 Microsoft Defender 防火墙，取消选中“阻止所有传入连接，包括位于允许应用列表中的应用。”将允许访问。

使用 ping 时出现“权限被拒绝”错误

对于 Windows 周年更新版本 1607，在 WSL 中运行 ping 命令需要拥有 Windows 中的管理员特权。若要运行 ping，请以管理员身份运行 Windows 上的 Ubuntu Bash，或使用管理员特权从 CMD/PowerShell 提示符运行 bash.exe。

对于更高版本的 Windows（内部版本 14926 及更高版本），则不再需要管理员特权。

Bash 挂起

如果使用 bash 时发现 bash 挂起（或死锁）且不响应输入，请收集并报告内存转储来帮助我们诊断问题。请注意，这些步骤会导致系统崩溃。如果你不熟悉此过程，请不要这样做，或者，请在执行此操作之前保存你的工作。

收集内存转储

将内存转储类型更改为“完整内存转储”。更改转储类型时，请记下当前类型。
遵循这些步骤使用键盘控制来配置崩溃。
再现挂起或死锁场景。
使用步骤 (2) 中的按键顺序来使系统崩溃。
系统将会崩溃并收集内存转储。
系统重新启动后，会将 memory.dmp 报告给 secure@microsoft.com。转储文件的默认位置是 %SystemRoot%\memory.dmp 或 C:\Windows\memory.dmp（如果 C: 是系统驱动器）。请注意，在电子邮件中，转储供 WSL 或 Windows 上的 Bash 团队参考。
将内存转储类型还原为原始设置。

检查内部版本号

若要查找电脑的体系结构和 Windows 内部版本号，请打开
“设置”>“系统”>“关于”

查看“OS 内部版本”和“系统类型”字段。
“内部版本”和“系统类型”字段的屏幕截图

若要查找 Windows Server 内部版本号，请在 PowerShell 中运行以下命令：

systeminfo | Select-String "^OS Name","^OS Version"

确认已启用 WSL

可通过在提升的 PowerShell 窗口中运行以下命令来确认是否已启用“适用于 Linux 的 Windows 子系统”：

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

OpenSSH 服务器连接问题

尝试连接 SSH 服务器失败并出现以下错误：“127.0.0.1 端口 22 已关闭连接”。

确保 OpenSSH 服务器正在运行：
```
sudo service ssh status
```
并已按照此教程进行操作： https://ubuntu.com/server/docs/service-openssh
停止 sshd 服务，然后在调试模式下启动 sshd：
```
sudo service ssh stop
sudo /usr/sbin/sshd -d
```

检查启动日志，确保已提供主机密钥，并且未看到如下所示的日志消息：

debug1: sshd version OpenSSH_7.2, OpenSSL 1.0.2g  1 Mar 2016
debug1: key_load_private: incorrect passphrase supplied to decrypt private key
debug1: key_load_public: No such file or directory
Could not load host key: /etc/ssh/ssh_host_rsa_key
debug1: key_load_private: No such file or directory
debug1: key_load_public: No such file or directory
Could not load host key: /etc/ssh/ssh_host_dsa_key
debug1: key_load_private: No such file or directory
debug1: key_load_public: No such file or directory
Could not load host key: /etc/ssh/ssh_host_ecdsa_key
debug1: key_load_private: No such file or directory
debug1: key_load_public: No such file or directory
Could not load host key: /etc/ssh/ssh_host_ed25519_key

如果确实看到了此类消息，并且 /etc/ssh/ 下缺少主机密钥，则必须重新生成这些密钥，或者只是清除并安装 OpenSSH 服务器：

sudo apt-get purge openssh-server
sudo apt-get install openssh-server

在启用 WSL 可选功能后出现“找不到引用的程序集。”

此错误与处于错误的安装状态相关。请完成以下步骤来尝试解决此问题：

如果是从 PowerShell 运行了启用 WSL 功能的命令，请尝试改用 GUI，方法是打开“开始”菜单，搜索“启用或关闭 Windows 功能”，然后在列表中选择“适用于 Linux 的 Windows 子系统”，这将安装可选组件。
转到“设置”、“更新”，然后单击“检查更新”来更新 Windows 版本
如果这两个操作均失败，并且你需要访问 WSL，请考虑使用安装介质重新安装 Windows 并选择“保留所有内容”以确保保留你的应用和文件，从而就地升级。可以在“重新安装 Windows 10”页面中找到有关如何执行此操作的说明。

如果看到此错误：

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@         WARNING: UNPROTECTED PRIVATE KEY FILE!          @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0777 for '/home/artur/.ssh/private-key.pem' are too open.

若要解决此问题，请将以下内容追加到 /etc/wsl.conf 文件：

[automount]
enabled = true
options = metadata,uid=1000,gid=1000,umask=0022

请注意，添加此命令将包含元数据并修改有关从 WSL 中看到的 Windows 文件的文件权限。有关详细信息，请参阅文件系统权限。

在分发中运行 Windows 命令失败

Microsoft Store 中提供的某些发行版尚不具备直接运行 Windows 命令的完全兼容性。如果在运行 powershell.exe /c start . 或任何其他 Windows 命令时收到错误 -bash: powershell.exe: command not found，可按照以下步骤予以解决：

在 WSL 分发中运行 echo $PATH。
如果不包括：/mnt/c/Windows/system32，表示有什么重新定义了标准 PATH 变量。
使用 cat /etc/profile 检查配置文件设置。
如果其中包含 PATH 变量的分配，则使用 # 字符来编辑文件，以注释掉 PATH 分配块。
检查 wsl.conf 是否存在 cat /etc/wsl.conf，并确保其中不包含 appendWindowsPath=false，否则请将其注释掉。
通过键入 wsl -t 后跟分发名称，或者在 cmd 或 PowerShell 中运行 wsl --shutdown 来重启分发。

安装 WSL 2 后无法启动

我们注意到用户在安装 WSL 2 后无法启动的问题。我们对该问题进行了全面诊断，而用户报告称更改缓冲区大小或安装适当的驱动程序可帮助解决此问题。请查看此 GitHub 问题了解有关此问题的最新更新。

禁用 ICS 时出现 WSL 2 错误

Internet 连接共享 (ICS) 是 WSL 2 的必需组件。主机网络服务 (HNS) 使用 ICS 服务来创建基础虚拟网络，WSL 2 依赖该网络来进行 NAT、DNS、DHCP 和主机连接共享。

禁用 ICS 服务 (SharedAccess) 或通过组策略禁用 ICS 会阻止创建 WSL HNS 网络。这将导致在创建新的 WSL 版本 2 映像时失败，并在尝试将版本 1 映像转换为版本 2 时出现以下错误。

There are no more endpoints available from the endpoint mapper.

需要 WSL 2 的系统应将 ICS 服务 (SharedAccess) 保留在“手动(触发启动)”这一默认启动状态，并且应覆盖或删除禁用 ICS 的所有策略。虽然禁用 ICS 服务会破坏 WSL 2，我们不建议禁用 ICS，但可以使用这些说明禁用 ICS 部分。

使用旧版 Windows 和 WSL

如果运行的是旧版 Windows 和 WSL，例如 Windows 10 创意者更新（2017 年 10 月的内部版本 16299）或周年更新（2016 年 8 月的内部版本 14393），则有几处差异需要注意。建议更新到最新的 Windows 版本，但如果无法执行此操作，请了解下面概述的一些差异。

互操作性命令差异：

bash.exe 已替换为 wsl.exe。可以从 Windows 命令提示或 PowerShell 运行 Linux 命令，但对于早期 Windows 版本，可能需要使用 bash 命令。例如：C:\temp> bash -c "ls -la"。传入 bash -c 的 WSL 命令将按原样转发到 WSL 进程。必须以 WSL 格式指定文件路径，并且必须谨慎转义相关字符。例如 C:\temp> bash -c "ls -la /proc/cpuinfo" 或 C:\temp> bash -c "ls -la \"/mnt/c/Program Files\""。
若要查看哪些命令适用于特定的分发版，请运行 [distro.exe] /?。举个使用 Ubuntu 的例子：C:\> ubuntu.exe /?。
Windows 路径包含在 WSL $PATH 中。
从早期的 Windows 10 版本中的 WSL 分发版调用 Windows 工具时，需要指定目录路径。例如，若要通过 WSL 命令行调用 Windows 记事本应用，请输入：/mnt/c/Windows/System32/notepad.exe
若要将默认用户更改为 root，请在 PowerShell 中使用此命令：C:\> lxrun /setdefaultuser root，然后运行 Bash.exe 登录：C:\> bash.exe。使用发行版密码命令 ($ passwd username) 重置密码，然后关闭 Linux 命令行 ($ exit)。在 Windows 命令提示符或 Powershell 中，将默认用户重置回常规的 Linux 用户帐户：C:\> lxrun.exe /setdefaultuser username。

卸载旧版 WSL

如果最初在创意者更新（2017 年 10 月的内部版本 16299）前的某个 Windows 10 版本上安装了 WSL，我们建议你将任何必需的文件、数据等从安装的旧 Linux 发行版迁移到通过 Microsoft Store 安装的新发行版。若要从计算机中删除旧发行版，请通过命令行或 PowerShell 实例运行以下命令：wsl --unregister Legacy。还可以选择手动删除旧发行版，方法是使用 Windows 文件资源管理器或 PowerShell 删除 %localappdata%\lxss\ 文件夹（及其所有子内容）：rm -Recurse $env:localappdata/lxss/。

排查适用于 Linux 的 Windows 子系统问题

提交问题、bug 报告、功能请求

安装问题

常见问题

我在使用 Windows 10 版本 1903，但我还是没看见 WSL 2 选项

错误：使用 `wsl --set-default-version 2` 时显示 0x1bc

无法从 Windows 访问 WSL 文件

无法启动 WSL 2 发行版，仅在输出中看到“WSL 2”

在 linux 中执行 windows .exe 时，`command not found`

Windows 更新后出现“错误:0x80370102 由于未安装所需功能，因此无法启动虚拟机。”

WSL 在工作计算机上或在企业环境中没有网络连接

WSL 在连接到 VPN 后没有网络连接

启动 WSL 或安装分发版会返回一个错误代码

更新 WSL

Apt-get upgrade 错误

Windows 更新后出现“错误:0x80040306”

Windows 更新后出现“错误:0x80040154”

更改显示语言

Windows 系统还原后出现的安装问题

在 WSL 中无法进行 Internet 访问

使用 ping 时出现“权限被拒绝”错误

Bash 挂起

检查内部版本号

确认已启用 WSL

OpenSSH 服务器连接问题

在启用 WSL 可选功能后出现“找不到引用的程序集。”

在分发中运行 Windows 命令失败

安装 WSL 2 后无法启动

禁用 ICS 时出现 WSL 2 错误

使用旧版 Windows 和 WSL

卸载旧版 WSL

其他资源

其他资源

排查适用于 Linux 的 Windows 子系统问题

提交问题、bug 报告、功能请求

安装问题

常见问题

我在使用 Windows 10 版本 1903，但我还是没看见 WSL 2 选项

错误：使用 wsl --set-default-version 2 时显示 0x1bc

无法从 Windows 访问 WSL 文件

无法启动 WSL 2 发行版，仅在输出中看到“WSL 2”

在 linux 中执行 windows .exe 时，command not found

Windows 更新后出现“错误:0x80370102 由于未安装所需功能，因此无法启动虚拟机。”

WSL 在工作计算机上或在企业环境中没有网络连接

WSL 在连接到 VPN 后没有网络连接

启动 WSL 或安装分发版会返回一个错误代码

更新 WSL

Apt-get upgrade 错误

Windows 更新后出现“错误:0x80040306”

Windows 更新后出现“错误:0x80040154”

更改显示语言

Windows 系统还原后出现的安装问题

在 WSL 中无法进行 Internet 访问

使用 ping 时出现“权限被拒绝”错误

Bash 挂起

检查内部版本号

确认已启用 WSL

OpenSSH 服务器连接问题

在启用 WSL 可选功能后出现“找不到引用的程序集。”

更正（SSH 相关）权限错误

在分发中运行 Windows 命令失败

安装 WSL 2 后无法启动

禁用 ICS 时出现 WSL 2 错误

使用旧版 Windows 和 WSL

卸载旧版 WSL

其他资源

其他资源

错误：使用 `wsl --set-default-version 2` 时显示 0x1bc

在 linux 中执行 windows .exe 时，`command not found`