使用 Windows 終端機的命令列引數

您可以使用 wt.exe 從命令列開啟新的 Windows 終端機執行個體。 您也可以改為使用執行別名 wt

注意

如果您是透過 GitHub 上的原始程式碼建置 Windows 終端機,則可以使用 wtd.exewtd 來開啟該組建。

分割窗格的 Windows 終端機命令列引數

命令列語法

wt 命令列可接受兩種類型的值:選項命令選項是可以控制整個 wt 命令列行為的旗標和其他參數所構成的清單。 命令可提供所應實作的單一動作或動作清單 (後者以分號分隔)。 如果未指定任何命令,則預設會將命令假設為 new-window

wt [options] [command ; ]

注意

命令的行為 wt.exe 可能會受到windowingBehavior 屬性的影響。 此設定可以調整為開啟新視窗或開啟新索引標籤之間的預設值。

若要顯示列出了可用命令列引數的說明訊息,請輸入:wt -hwt --helpwt -?wt /?

選項和命令

以下是 wt 命令列所支援的完整命令和選項清單。

選項 說明
--help, -h, -?, /? 顯示說明訊息。
--maximized, -M 啟動最大化的終端機。
--fullscreen, -F 以全螢幕形式啟動終端機。
--focus, -f 以焦點模式啟動終端機。 可以與 maximized 結合。
--window, -w<window-id> 在特定視窗中啟動終端機。

New-tab 命令

命令 參數 描述
new-tab, nt --profile, -p profile-name 根據指派的設定檔名稱建立新的索引標籤。 設定檔名稱
new-tab, nt --startingDirectory, -d starting-directory 根據指派的起始目錄路徑建立新的索引標籤。 目錄路徑
new-tab, nt commandline 根據指派的命令列建立新的索引標籤。 具有選擇性命令的可執行檔
new-tab, nt --title 使用指派的標題建立新的索引標籤。 要當做索引標籤標題使用的文字
new-tab, nt --tabColor 使用指派的索引標籤色彩建立新的索引標籤。 十六進位色彩做為#RGB或#RRGGBB

提示

如果您變更Windows 終端機索引標籤的標題,並想要保存該標題,則必須將它設定為 true 來啟用suppressApplicationTitle選項。

Split-pane 命令

命令 參數 描述
split-pane, sp -H, --horizontal, -V, --vertical 水準或垂直建立新的分割視窗窗格。 N/A。 沒有要指派的其他值。
split-pane, sp --profile, -p profile-name 根據指派的命令列設定檔建立新的分割視窗窗格。 如果未指派此參數,則會使用預設設定檔。 設定檔名稱
split-pane, sp --startingDirectory, -d starting-directory 根據指派的起始目錄路徑,建立新的分割視窗窗格。 如果未指派此參數,則會使用預設的起始目錄。 目錄路徑
split-pane, sp --title 使用指派的標題建立新的分割視窗窗格。 要當做索引標籤標題使用的文字
split-pane, sp --tabColor 使用指派的索引標籤色彩建立新的分割視窗窗格。 十六進位色彩做為#RGB或#RRGGBB
split-pane, sp --size, -s size 使用指派的大小建立新的分割視窗窗格。 Float,指定要以十進位表示之父窗格的部分。 例如, .4 表示父窗格的 40%。
split-pane, sp commandline 根據指派的命令列建立新的分割視窗窗格。 具有選擇性命令的可執行檔
split-pane, sp --duplicate, -D 建立新的分割視窗窗格,該窗格是目前窗格的複本。 N/A。 沒有要指派的其他值。

Focus-tab 命令

命令 參數 描述
focus-tab, ft --target, -t tab-index 根據索引標籤的索引編號,將焦點放在特定的索引標籤上。 索引標籤索引做為整數

Move-focus 命令

命令 參數 描述
move-focus, mf direction 在指定方向的窗格之間移動焦點。 up已接受 、 downleftright 值。

注意

從 cmd (命令提示字元) 開啟Windows 終端機時,如果您想要使用自訂的 「cmd」 設定檔設定,則必須使用 命令 wt -p cmd 。 否則,若要執行 預設 設定檔設定,只需使用 wt cmd

命令列引數範例

命令可能會隨您所使用的命令列而略有不同。

將引數傳遞至預設殼層

若要啟動 Windows 終端機 的實例,並讓它執行命令,請呼叫 wt.exe ,後面接著您的命令。

以下是呼叫 Windows 終端機 以傳遞ping命令引數以回應 IP 位址的範例:

wt ping docs.microsoft.com

以下是呼叫 Windows 終端機 以使用 PowerShell 命令列開啟新索引標籤、確認呼叫Start-Service命令,以及開啟另一個新的索引標籤,並將 Windows 命令提示字元開啟至 /k 目錄的範例:

wt new-tab PowerShell -c Start-Service ; new-tab cmd /k dir

以特定視窗為目標

以下是如何使用 選項鎖定特定視窗的 --window,-w 範例。

// Open a new tab with the default profile in the current window
wt -w 0 nt

// Open a new tab in a new window with the default profile
wt -w -1 nt

// Open a new tab in the first-created terminal window with the default profile
wt -w 1 nt

// Open a new tab in the terminal window named foo with the default profile. If foo does not exist, create a new window named foo.
wt -w foo nt

開啟新的設定檔執行個體

若要開啟新的終端機執行個體 (在本案例中,命令會開啟名為 "Ubuntu-18.04" 的設定檔),請輸入:

wt -p "Ubuntu-18.04"

-p 旗標可用來指定應該開啟的 Windows 終端機設定檔。 請以所安裝的任何終端機設定檔名稱取代 "Ubuntu-18.04"。 這一律會開啟新的視窗。 Windows 終端機尚未能夠在現有執行個體中開啟新的索引標籤或窗格。

將目標定為某個目錄

若要指定應該作為主控台起始目錄的資料夾 (在本案例中為 d:\ 目錄),請輸入:

wt -d d:\

多個索引標籤

若要開啟有多個索引標籤的新終端機執行個體,請輸入:

wt ; ;

若要開啟有多個索引標籤的新終端機執行個體 (在本案例中為命令提示字元設定檔和 PowerShell 設定檔),請輸入:

wt -p "Command Prompt" ; new-tab -p "Windows PowerShell"

多個窗格

若要開啟新的終端機執行個體,使其擁有一個索引標籤,內含三個分別執行命令提示字元設定檔、PowerShell 設定檔和您的預設設定檔 (執行 WSL 命令列) 的窗格,請輸入:

wt -p "Command Prompt" ; split-pane -p "Windows PowerShell" ; split-pane -H wsl.exe

-H 旗標 (或 --horizontal) 會指出您想要水平分割窗格。 -V 旗標 (或 --vertical) 會指出您想要垂直分割窗格。

多個索引標籤和窗格

new-tabsplit-pane 命令可以排序以取得多個索引標籤,每個索引標籤都有分割窗格。 若要開啟具有兩個索引標籤的新終端機實例,每個都有兩個窗格執行命令提示字元和 WSL 命令列,且每個索引標籤位於不同的目錄中,輸入:

wt -p "Command Prompt" ; split-pane -V wsl.exe ; new-tab -d c:\ ; split-pane -H -d c:\ wsl.exe

窗格標題

若要針對每個終端機窗格開啟具有自訂標題的新終端機實例,請使用 自 --title 變數。 若要在開啟多個索引標籤時設定每個窗格的標題,請輸入:

wt --title tabname1 ; new-tab -p "Ubuntu-18.04" --title tabname2

相同索引標籤中的窗格可以有不同的標題,這會根據窗格的焦點反映在索引標籤標題上。 若要命名獨立窗格,您可以輸入下列命令,在分割窗格之後設定標題:

wt --title pane1 ; split-pane -p "Command Prompt" --title pane2

使用應用程式標題

若要開啟新的終端機實例,允許應用程式透過傳送標題變更訊息來設定索引標籤標題,請使用 --useApplicationTitle 旗標。 若要隱藏這些訊息,請使用 --suppressApplicationTitle 旗標。 如果未提供這些旗標,則行為會繼承自設定檔的設定。 若要開啟標題為應用程式不會覆寫的索引 tabname 標籤,請輸入:

wt --title tabname --suppressApplicationTitle

索引標籤色彩

若要以自訂索引標籤色彩開啟新的終端機實例,請使用 自 --tabColor 變數。 此引數會覆寫設定檔中定義的值,但也可以使用索引標籤色彩選擇器來覆寫。 在下列範例中,系統會使用兩個不同色彩的索引標籤來建立新的終端機:

wt --tabColor #009999 ; new-tab --tabColor #f59218

當為索引標籤設定時 --tabColor ,它會與此索引標籤的第一個窗格相關聯。因此,在具有多個窗格的索引標籤中,只有在第一個窗格處於焦點時,才會套用色彩。 若要設定其他窗格的索引標籤色彩,您也必須將 參數新增 --tabColorsplit-pane 子命令。 在下列範例中,會建立具有兩個窗格的索引標籤,並為每個窗格指定索引標籤色彩:

wt new-tab --tabColor '#009999' `; split-pane --tabColor '#f59218'

色彩配置

若要開啟具有特定色彩配置的新終端機實例, (colorScheme 而不是設定檔) 中的集合,請使用 --colorScheme 引數。 這個引數會覆寫設定檔中定義的值。

wt --colorScheme Vintage ; split-pane --colorScheme "Tango Light"

索引標籤焦點

若要開啟新的終端機執行個體,並使其具有焦點所在的特定索引標籤,請使用 -t 旗標 (或 --target) 以及索引標籤索引編號。 若要在第一個索引標籤中開啟預設設定檔,並在第二個索引標籤 (-t 1) 中開啟焦點所在的 "Ubuntu-18.04" 設定檔,請輸入:

wt ; new-tab -p "Ubuntu-18.04" ; focus-tab -t 1

PowerShell 發出多個命令的範例

Windows 終端機會使用分號字元 ; 作為分隔符號,以分隔 wt 命令列中的命令。 遺憾的是,PowerShell 也會使用 ; 來作為命令分隔符號。 若要解決此情況,您可以使用下列訣竅,從 PowerShell 執行多個 wt 命令。 下列所有範例會建立含有三個窗格的新終端機視窗:一個窗格執行命令提示字元、一個窗格執行 PowerShell,最後一個窗格執行 WSL。

下列範例則不會使用 start 來執行命令列。 相反地,另有兩種方法可逸出命令列:

  • 只逸出分號,讓 PowerShell 忽略分號,並將其直接傳遞給 wt
  • 使用 --%,讓 PowerShell 將命令列的其餘部分視為應用程式的引數。
wt new-tab "cmd" `; split-pane -p "Windows PowerShell" `; split-pane -H wsl.exe
wt --% new-tab cmd ; split-pane -p "Windows PowerShell" ; split-pane -H wsl.exe

在這兩個範例中,新建立的 Windows 終端機視窗都會藉由正確地剖析所提供的所有命令列引數來建立視窗。

不過,目前建議您使用這些方法,因為 PowerShell 會等到新建立的終端機視窗關閉後,才將控制權返還給 PowerShell。 根據預設,PowerShell 一律會等到 Windows 市集的應用程式 (如 Windows 終端機) 關閉後,才返回提示字元。 請注意,這與命令提示字元的行為不同,後者會立即返回提示字元。