适用于 Linux 的 Windows 子系统的命令参考

与适用于 Linux 的 Windows 子系统交互的最佳方式是使用 wsl.exe 命令。

将 WSL 2 设置为默认版本

安装新的 Linux 分发版时，请在 Powershell 中运行以下命令，以将 WSL 2 设置为默认版本：

wsl --set-default-version2

备注

如果你正在运行 32 位进程来访问 wsl.exe（一种 64 位工具），
那么你可能需要按如下方式运行上述命令：

C:\Windows\Sysnative\wsl.exe --set-default-version 2

将分发版版本设置为 WSL 1 或 WSL 2

可以打开 PowerShell 命令行并输入以下命令
（仅在 Windows 内部版本 19041 或更高版本中可用），
来检查分配给每个已安装的 Linux 分发版的 WSL 版本：wsl -l -v

wsl --list --verbose

若要将分发版设置为受某一 WSL 版本支持，请运行：

wsl --set-version <distribution name> <versionNumber>

请确保将 替换为你的分发版的实际名称，
并将 替换为数字“1”或“2”。 可以随时更改回 WSL 1，
方法是运行与上面相同的命令，但将“2”替换为“1”。

此外，如果要使 WSL 2 成为你的默认体系结构，可以通过此命令执行该操作：

wsl --set-default-version 2

这会将安装的任何新分发版的版本设置为 WSL 2。

wsl.exe

以下列表包含自 Windows 版本 1903 开始，在使用 wsl.exe 时可用的所有选项。

使用：wsl [Argument] [Options...] [CommandLine]

用于运行 Linux 命令的参数

• 不带参数
  如果未提供命令行，wsl.exe 将启动默认 shell。

• --exec , -e <CommandLine>
  执行指定的命令，但不使用默认的 Linux shell。

• -- 按原样传递剩余的命令行。

上述命令也接受以下选项：

• --distribution , -d <Distro>
  运行指定的分发版。

• --user , -u <UserName>
  以指定用户的身份运行。

用于管理适用于 Linux 的 Windows 子系统的参数

• --export <Distro> <FileName>
  将分发版导出到 tar 文件。 在标准输出中，文件名可以是 -。

• --import <Distro> <InstallLocation> <FileName>
  导入指定的 tar 文件作为新的分发版。 在标准输入中，文件名可以是 -。

• --list、-l [选项] 列出分发版。

选项：

• --all
  列出所有分发版，包括当前正在安装或卸载的分发版。

• --verbose , -v
  显示命令的附加信息或展开的详细信息。

• --running
  仅列出当前正在运行的分发版。

• --set-default , -s <Distro>
  将分发版设置为默认值。

• --terminate , -t <Distro>
  终止指定的分发版。

• --unregister <Distro>
  注销分发版。

• --help
  显示用法信息。

其他命令

还可以使用一些传统命令来与适用于 Linux 的 Windows 子系统交互。
这些命令的功能已包含在 wsl.exe 中，但仍可供使用。

wslconfig.exe

此命令可用于配置 WSL 分发版。 下面是其选项列表。

使用：wslconfig [Argument] [Options...]

参数

• /l 、 /list [选项]
  列出已注册的分发版。

选项：

• /all （可选）列出所有分发版，包括当前正在安装或卸载的分发版。
• /running 仅列出当前正在运行的分发版。
• /s , /setdefault <Distro> 将该发行版设置为默认版本。
• /t , /terminate <Distro> 终止发行版。
• /u , /unregister <Distro> 注销发行版。

• /upgrade <Distro> 将发行版升级为 WslFs 文件系统格式。

  bash.exe

此命令用于启动 bash shell。 下面是可在此命令中使用的选项。

使用：bash [Options...]

• 未指定选项
  在当前目录中启动 Bash shell。 如果未自动安装 Bash shell，请运行 lxrun /install

• ~ bash ~ 在用户的主目录中启动 bash shell。 类似于运行 cd ~。

• -c "<command>" 运行命令，列显输出，并返回到 Windows 命令提示符。

示例：bash -c "ls"。