適用於 Linux 的 Windows 子系統命令參考Command Reference for Windows Subsystem for Linux

與適用於 Linux 的 Windows 子系統互動的最佳方式是使用 wsl.exe 命令。The best way to interact with the Windows Subsystem for Linux is to use the wsl.exe command.

將 WSL 2 設定為預設版本Set WSL 2 as your default version

在 Powershell 中執行下列命令,以在安裝新的 Linux 發行版本時,將 WSL 2 設定為預設版本:Run the following command in Powershell to set WSL 2 as the default version when installing a new Linux distribution:

wsl --set-default-version 2

將發行版本設定為 WSL 1 或 WSL 2Set your distribution version to WSL 1 or WSL 2

若要針對每個已安裝的 Linux 發行版本檢查獲派的 WSL 版本,您可以開啟 PowerShell 命令列並輸入此命令 (僅適用於 Windows 組建 19041 或更高版本):wsl -l -vYou can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in Windows Build 19041 or higher): wsl -l -v

wsl --list --verbose

若要設定要由任一版 WSL 所支援的發行版本,請執行:To set a distribution to be backed by either version of WSL please run:

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

請務必將 <distribution name> 取代為發行版本的實際名稱,並使用數字 '1' 或 '2' 取代 <versionNumber>Make sure to replace <distribution name> with the actual name of your distribution and <versionNumber> with the number '1' or '2'. 您可以執行與上述相同的命令,隨時變更回 WSL 1,但將「2」取代為「1」。You can change back to WSL 1 at anytime by running the same command as above but replacing the '2' with a '1'.

此外,如果您要讓 WSL 2 成為您的預設架構,則可以使用以下命令來執行此動作:Additionally, if you want to make WSL 2 your default architecture you can do so with this command:

wsl --set-default-version 2

這會將已安裝的任何新發行版本設定為 WSL 2。This will set the version of any new distribution installed to WSL 2.

wsl.exe

以下清單包含在 Windows 1903 版使用 wsl.exe 時的所有選項。Below is a list containing all options when using wsl.exe as of Windows Version 1903.

使用:wsl [Argument] [Options...] [CommandLine]Using: wsl [Argument] [Options...] [CommandLine]

執行 Linux 命令的引數Arguments for running Linux commands

  • 不含引數Without arguments

    如果未提供任何命令列,則 wsl 會啟動預設的命令介面。If no command line is provided, wsl.exe launches the default shell.

  • --exec, -e <CommandLine>--exec, -e <CommandLine>

    執行指定的命令,而不使用預設的 Linux 命令介面。Execute the specified command without using the default Linux shell.

  • --

    依情況傳遞其餘的命令列。Pass the remaining command line as is.

上述命令也接受下列選項:The above commands also accept the following options:

  • --distribution, -d <Distro>--distribution, -d <Distro>

    執行指定的散發套件。Run the specified distribution.

  • --user, -u <UserName>--user, -u <UserName>

    以指定的使用者身分執行。Run as the specified user.

用於管理適用於 Linux 的 Windows 子系統的引數Arguments for managing Windows Subsystem for Linux

  • --export <Distro> <FileName>--export <Distro> <FileName>

    將散發套件匯出至 tar 檔案。Exports the distribution to a tar file. 標準輸出的檔案名稱可以是:The filename can be - for standard output.

  • --import <Distro> <InstallLocation> <FileName>--import <Distro> <InstallLocation> <FileName>

    匯入指定的 tar 檔案作為新的散發套件。Imports the specified tar file as a new distribution. 標準輸入的檔案名稱可以是:The filename can be - for standard input.

  • --list, -l [Options]--list, -l [Options]

    Linux 散發套件。Lists distributions.

    選項:Options:

    • --all--all

      列出所有散發套件,包括目前正在安裝或解除安裝的散發套件。List all distributions, including distributions that are currently being installed or uninstalled.

    • --running--running

      僅列出目前正在執行的散發套件。List only distributions that are currently running.

  • --set-default, -s <Distro>--set-default, -s <Distro>

    將散發套件設定為預設值。Sets the distribution as the default.

  • --terminate, -t <Distro>--terminate, -t <Distro>

    終止指定的散發套件。Terminates the specified distribution.

  • --unregister <Distro>--unregister <Distro>

    取消註冊發行版本。Un-register the distribution.

  • --help 顯示使用方式資訊。--help Display usage information.

其他命令Additional Commands

還有與適用於 Linux 的 Windows 子系統互動的歷史命令。There are also historic commands to interact with the Windows Subsystem for Linux. 其功能包含在 wsl.exe 中,但仍可供使用。Their functionality is encompassed within wsl.exe, but they are still available for use.

wslconfig.exe

此命令可讓您設定 WSL 散發套件。This command lets you configure your WSL distribution. 以下是其選項的清單。Below is a list of its options.

使用: wslconfig [Argument] [Options...]Using: wslconfig [Argument] [Options...]

引數Arguments

  • /l, /list [Options]/l, /list [Options]

    列出已註冊的散發套件。Lists registered distributions.

選項:Options:

  • /all 選擇性地列出所有發行版本,包括目前正在安裝或解除安裝的發行版本。/all Optionally list all distributions, including distributions that are currently being installed or uninstalled.

  • /running 僅列出目前正在執行的發行版本。/running List only distributions that are currently running.

  • /s, /setdefault <Distro> 將發行版本設定為預設值。/s, /setdefault <Distro> Sets the distribution as the default.

  • /t, /terminate <Distro> 終止發行版本。/t, /terminate <Distro> Terminates the distribution.

  • /u, /unregister <Distro> 取消註冊發行版本。/u, /unregister <Distro> Un-registers the distribution.

  • /upgrade <Distro> 將發行版本升級為 WslFs 檔案系統格式。/upgrade <Distro> Upgrades the distribution to the WslFs file system format.

bash.exe

此命令可用來啟動 bash 命令介面。This command is used to start a bash shell. 以下是您可以搭配此命令使用的選項。Below are the options you can use with this command.

使用:bash [Options...]Using: bash [Options...]

  • 未指定任何選項No Option given

    在目前目錄中啟動 Bash 命令介面。Launches the Bash shell in the current directory. 如果未安裝 Bash 命令介面,則會自動執行 lxrun /installIf the Bash shell is not installed automatically runs lxrun /install

  • ~

    bash ~ 在使用者的主目錄中啟動 bash 命令介面。bash ~ launches the bash shell into the user's home directory. 類似於執行 cd ~Similar to running cd ~.

  • -c "<command>"-c "<command>"

    執行命令,列印輸出並結束回到 Windows 命令提示字元。Runs the command, prints the output and exits back to the Windows command prompt.

    範例:bash -c "ls"Example: bash -c "ls".

已過時的命令Deprecated Commands

lxrun.exe 是用來安裝和管理適用於 Linux 的 Windows 子系統的第一個命令。The lxrun.exe was the first command used to install and manage the Windows Subsystem for Linux. 它已被取代為 Windows 10 1803 和更新版本。It is deprecated as of Windows 10 1803 and later.

lxrun.exe 命令可以用來直接與適用於 Linux 的 Windows 子系統 (WSL) 互動。The command lxrun.exe can be used to interact with the Windows Subsystem for Linux (WSL) directly. 這些命令會安裝到 \Windows\System32 目錄中,而且可以在 Windows 命令提示字元或 PowerShell 中執行。These commands are installed into the \Windows\System32 directory and may be run within a Windows command prompt or in PowerShell.

命令Command 說明Description
lxrun lxrun 命令是用來管理 WSL 執行個體。The lxrun command is used to manage the WSL instance.
lxrun /install 開始下載和安裝程序。Starts the download and install process.
可能會新增 /y 以略過所有提示。/y may be added to bypass all prompts. 系統會自動接受確認提示,並將預設使用者設定為 [根]。The confirmation prompt is automatically accepted and the default user is set to root.
lxrun /uninstall 解除安裝並刪除 Ubuntu 映像。Uninstalls and deletes the Ubuntu image. 根據預設,這不會移除使用者的 Ubuntu 主目錄。By default this does not remove the user's Ubuntu home directory.
可能會新增 /y 以自動接受確認提示/y may be added to automatically accept the confirmation prompt
/full 會解除安裝並刪除使用者的 Ubuntu 主目錄/full uninstalls and deletes the user's Ubuntu home directory
lxrun /setdefaultuser <userName> 設定 Ubuntu 使用者的預設 Bash。Sets the default Bash on Ubuntu user. 如果指定的使用者不存在,會提示密碼。Will prompt for a password if the specified user does not exist. 如需詳細資訊,請造訪: https://aka.ms/wslusersFor more information visit: https://aka.ms/wslusers.
/y 會略過密碼的提示。/y Bypasses promping for the password. 將建立不含密碼的使用者。The user will be created without a password.
lxrun /update 更新子系統的套件索引Updates the subsystem's package index