使用 wt.exe 从命令行打开一个新的 Windows 终端实例。 还可以改用执行别名 wt 。
注释
如果从 GitHub 上的源代码生成 Windows 终端，则可以使用 wtd.exe 或 wtd打开该生成。
命令行语法
wt命令行接受两种类型的值：选项和命令。
选项 是一系列标志和其他参数，用于控制整个命令行的行为 wt 。
命令 提供命令行实现的操作或以分号分隔的操作列表。 如果未指定命令，则命令行默认使用 new-tab 。
wt [options] [command ; ]
注释
该windowingBehavior属性可能会影响wt.exe命令的行为。 将此设置调整为打开新窗口或打开新选项卡之间的默认值。
若要显示列出可用命令行参数的帮助消息，请输入： wt -h、 wt --help、 wt -?或 wt /?。
选项和命令
下面是命令行支持的命令和选项 wt 的完整列表。
选项
Description
--help, -h, -?, /?
显示帮助消息。
--maximized, -M
启动最大化的终端。
--fullscreen, -F
以全屏模式启动终端。
--focus, -f
在焦点模式下启动终端。 可以与 maximized..
--pos x,y
在给定位置启动终端。
x 或 y 可以省略，以使用设置中的默认值。
--size
c,r
使用指定的列数（c）和行（r）启动终端。
--window, -w window-id
在特定窗口中运行给定的命令。
该 --window 参数可用于将命令发送到现有终端窗口。
window-id 可以是窗口的整数 ID，也可以是窗口的名称。 它还接受以下保留值：
new 或 -1：始终在新窗口中运行此命令
last 或 0：始终在最近使用的窗口中运行此命令
如果给定 window-id的窗口不存在，则将使用该 ID/名称创建新窗口。
例如，运行wt -w _quake将打开新的“地震窗口”。 再次运行该命令将在现有地震窗口中打开一个新选项卡。
新建选项卡命令
使用此命令创建新选项卡。有关详细信息，请参阅动作newTab。
Command
参数
Description
价值观
new-tab、nt
--profile, -p profile-name
基于分配的配置文件名称创建新选项卡。
配置文件名称
new-tab、nt
--startingDirectory, -d starting-directory
基于分配的起始目录路径创建新选项卡。
目录路径
new-tab、nt
--title title
创建分配有标题的新选项卡。
要用作选项卡标题的文本
new-tab、nt
--tabColor hex-color
使用分配的选项卡颜色创建新选项卡。
十六进制颜色作为 #RGB 或 #RRGGBB
new-tab、nt
--suppressApplicationTitle
重写配置文件的设置 suppressApplicationTitle ，并将其设置为 true
new-tab、nt
--useApplicationTitle
重写配置文件的设置 suppressApplicationTitle ，并将其设置为 false
new-tab、nt
--colorScheme scheme-name
重写配置文件的设置 colorScheme ，并从名称的设置中将其设置为方案 scheme-name
设置中配色方案的名称
new-tab、nt
--appendCommandLine
将提供的命令行追加到配置文件的默认命令，而不是替换它
new-tab、nt
--inheritEnvironment, !--reloadEnvironment
在创建新会话时继承终端自己的环境变量，而不是创建新的环境块。 这默认设置为在传递时 commandline 设置。
new-tab、nt
commandline
基于分配的命令行创建新选项卡。
具有可选参数的可执行文件
小窍门
如果更改 Windows 终端中选项卡的标题，并且希望该标题保留，则必须通过将它设置为 来启用 suppressApplicationTitle 选项。
拆分窗格命令
使用此命令创建新的拆分窗格。 有关详细信息，请参阅 splitPane 操作。
Command
参数
Description
价值观
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. 没有要分配的其他值。
split-pane、sp
--suppressApplicationTitle
覆盖配置文件的 suppressApplicationTitle 设置，并将其设置为 true。
split-pane、sp
--useApplicationTitle
重写配置文件的设置 suppressApplicationTitle ，并将其设置为 false。
split-pane、sp
--colorScheme scheme-name
重写配置文件的设置 colorScheme ，并从名称 scheme-name的设置中将其设置为方案。
设置中配色方案的名称
Focus-tab 命令
使用此命令可聚焦窗口中的特定选项卡。 有关详细信息，请参阅 switchToTab 操作。
Command
参数
Description
价值观
focus-tab、ft
--target, -t tab-index
根据选项卡索引号聚焦于特定选项卡。
制表符索引为整数
移动焦点命令
使用此命令可在窗口中移动焦点。 有关详细信息，请参阅 moveFocus 操作。
Command
参数
Description
价值观
move-focus、mf
在窗格之间移动焦点。
有关接受 direction 的值，请参阅下文
接受 direction 的值
up、 down、 left或 right 移动焦点在给定的方向。
first 将焦点移动到树中的第一个叶窗格。
previous 将焦点移动到当前窗格之前最近使用的窗格。
nextInOrder， previousInOrder 按创建顺序将焦点移动到下一个或上一个窗格。
Move-pane 命令
使用此命令在窗口中移动窗格。 有关详细信息，请参阅 movePane 操作。
Command
参数
Description
价值观
move-pane、mp
--tab,-t
将活动窗格移动到窗口中的给定选项卡
要移动到窗格的选项卡的零索引索引。
交换窗格命令
使用此命令交换窗口中两个窗格的位置。 另请参阅作swapPane。
Command
参数
Description
价值观
swap-pane
将窗格交换为给定方向的窗格
有关接受 direction 的值，请参阅下文
接受 direction 的值（这些值与 move-focus 子命令相同）：
up、 down、 left或 right：将活动窗格与给定方向的窗格交换。
first：将活动窗格与树中的第一个叶窗格交换。
previous：将活动窗格与当前窗格之前最近使用的窗格交换。
nextInOrder， previousInOrder：按创建顺序将活动窗格与下一个或上一个窗格交换。
命令行参数示例
命令可能会略有不同，具体取决于所使用的命令行。
将参数传递给默认 shell
若要启动 Windows 终端的实例并让其执行命令，请调用 wt.exe 后跟命令。
下面是调用 Windows 终端以传递 ping 命令参数以回显 IP 地址的示例：
wt ping learn.microsoft.com
下面是一个示例：调用 Windows 终端以使用 PowerShell 命令行打开新选项卡、确认调用 Start-Service 命令，并打开另一个新选项卡，其中 Windows 命令提示符打开到 /k 目录：
wt new-tab PowerShell -c Start-Service ; new-tab cmd /k dir
面向特定窗口
以下示例演示如何使用选项 --window,-w 以特定窗口为目标。
命令提示符
PowerShell
Linux
// 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
// 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 then, create a new window named foo.
wt -w foo nt
// Open a new tab with the default profile in the current window
cmd.exe /c "wt.exe" -w 0 nt
// Open a new tab in a new window with the default profile
cmd.exe /c "wt.exe" -w -1 nt
// Open a new tab in the first-created terminal window with the default profile
cmd.exe /c "wt.exe" -w 1 nt
// Open a new tab in the terminal window named foo with the default profile. If foo does not exist then, create a new window named foo.
cmd.exe /c "wt.exe" -w foo nt
执行别名在 WSL 发行版中不起作用。 如果要从 WSL 命令行使用 wt.exe，可以通过运行 cmd.exe直接从 CMD 生成它。 此选项 /c 指示 CMD 在运行后终止。
打开新的配置文件实例
若要打开名为“Ubuntu-18.04”的新终端实例，请输入：
命令提示符
PowerShell
Linux
wt -p "Ubuntu-18.04"
wt -p "Ubuntu-18.04"
cmd.exe /c "wt.exe" -p "Ubuntu-18.04"
执行别名在 WSL 发行版中不起作用。 如果要从 WSL 命令行使用 wt.exe，可以通过运行 cmd.exe直接从 CMD 生成它。 此选项 /c 指示 CMD 在运行后终止。
使用 -p 标志指定要打开的 Windows 终端配置文件。 将“Ubuntu-18.04”替换为安装的任何终端配置文件的名称。 此命令始终打开一个新窗口。 若要在 Windows 终端的现有（已打开）实例中打开新的 shell 选项卡，请使用： wt -w [window id](#options-and-commands) [executable name] 例如， wt -w 0 cmd 在 Windows 终端的最新实例中打开命令提示符 shell。 如果您要启动一个配置文件（这个文件结合了 shell 可执行文件、配色方案、标题、命令，以及其他控制它如何与控制台会话交互的设置），那么您必须在命令中使用这个配置文件的名称：wt -w 0 -p "Profile Name"。
目标目录
若要指定控制台用作起始目录的文件夹，请输入以下命令。 在此示例中，起始目录是 d:\ 目录：
命令提示符
PowerShell
Linux
wt -d d:\
wt -d d:\
cmd.exe /c "wt.exe" -d d:\
执行别名在 WSL 发行版中不起作用。 如果要从 WSL 命令行使用 wt.exe，可以通过运行 cmd.exe直接从 CMD 生成它。 此选项 /c 指示 CMD 在运行后终止。
多个选项卡
若要打开具有多个选项卡的新终端实例，请输入：
命令提示符
PowerShell
Linux
wt ; ;
wt `; `;
PowerShell 使用分号 ; 分隔语句。 若要将分号 ; 解释为 wt 命令行参数的命令分隔符，需要使用反引号对分号字符进行转义。 PowerShell 还具有停止分析运算符（--%），它指示它停止解释它之后的任何内容，并只是逐字传递它。
cmd.exe /c "wt.exe" \; \;
执行别名在 WSL 发行版中不适用。 如果要从 WSL 命令行使用 wt.exe，可以通过运行 cmd.exe直接从 CMD 生成它。 此选项 /c 指示 CMD 在运行后终止。
若要打开包含多个选项卡的新终端实例，在本例中为命令提示符配置文件和 PowerShell 配置文件，请输入：
命令提示符
PowerShell
Linux
wt -p "Command Prompt" ; new-tab -p "Windows PowerShell"
wt -p "Command Prompt" `; new-tab -p "Windows PowerShell"
PowerShell 使用分号 ; 分隔语句。 若要将分号 ; 解释为 wt 命令行参数的命令分隔符，需要使用反引号来转义分号字符。 PowerShell 还具有停止分析运算符（--%），它指示它停止解释它之后的任何内容，并只是逐字传递它。
cmd.exe /c "wt.exe" -p "Command Prompt" \; new-tab -p "Windows PowerShell"
执行别名在 WSL 分发版中不起作用。 如果要从 WSL 命令行使用 wt.exe，可以通过运行 cmd.exe直接从 CMD 生成它。 该 /c 选项指示 CMD 在运行 \; 后终止，反斜杠 + 分号分隔命令。
多个窗格
若要打开包含三个运行命令提示符配置文件、PowerShell 配置文件和运行 WSL 命令行的默认配置文件的选项卡的新终端实例，请输入：
命令提示符
PowerShell
Linux
wt -p "Command Prompt" ; split-pane -p "Windows PowerShell" ; split-pane -H wsl.exe
wt -p "Command Prompt" `; split-pane -p "Windows PowerShell" `; split-pane -H wsl.exe
PowerShell 使用分号 ; 分隔语句。 若要在 wt 命令行参数中将分号 ; 解释为命令分隔符，需要使用反引号来转义分号字符。 PowerShell 还具有停止分析运算符（--%），它指示它停止解释它之后的任何内容，并只是逐字传递它。
cmd.exe /c "wt.exe" -p "Command Prompt" \; split-pane -p "Windows PowerShell" \; split-pane -H wsl.exe
执行别名在 WSL 发行版中不起作用。 如果要从 WSL 命令行使用 wt.exe，可以通过运行 cmd.exe直接从 CMD 生成它。 该 /c 选项指示 CMD 在运行 \; 后终止，反斜杠 + 分号分隔命令。
标志 -H （或 --horizontal）指示希望水平拆分窗格。 标志 -V （或 --vertical）指示希望窗格垂直拆分。
多个选项卡和窗格
依次执行new-tab和split-pane命令，以便每个选项卡都有拆分窗格。 若要打开包含两个选项卡的新终端实例，每个窗格都运行命令提示符和 WSL 命令行，每个选项卡位于不同的目录中，输入：
命令提示符
PowerShell
Linux
wt -p "Command Prompt" ; split-pane -V wsl.exe ; new-tab -d c:\ ; split-pane -H -d c:\ wsl.exe
wt -p "Command Prompt" `; split-pane -V wsl.exe `; new-tab -d c:\ `; split-pane -H -d c:\ wsl.exe
PowerShell 使用分号 ; 分隔语句。 若要将分号 ; 解释为 wt 命令行参数的命令分隔符，需要使用反引号来转义分号字符。 PowerShell 还具有停止分析运算符（--%），它指示它停止解释它之后的任何内容，并只是逐字传递它。
cmd.exe /c "wt.exe" -p "Command Prompt" \; split-pane -V wsl.exe \; new-tab -d c:\\ \; split-pane -H -d c:\\ wsl.exe
执行别名在 WSL 分发版中不起作用。 如果要从 WSL 命令行使用 wt.exe，可以通过运行 cmd.exe直接从 CMD 生成它。 该 /c 选项指示 CMD 在运行 \; 后终止，反斜杠 + 分号分隔命令。 若要将 Windows 目录指定为起始目录 wsl.exe，需要两个反斜杠 \\。
窗格标题
若要为每个终端窗格打开具有自定义标题的新终端实例，请使用 --title 该参数。 若要在打开多个选项卡时设置每个窗格的标题，请输入：
命令提示符
PowerShell
Linux
wt --title tabname1 ; new-tab -p "Ubuntu-18.04" --title tabname2
wt --title tabname1 `; new-tab -p "Ubuntu-18.04" --title tabname2
PowerShell 使用分号 ; 分隔语句。 若要将分号 ; 解释为 wt 命令行参数的命令分隔符，需要使用反引号来转义分号字符。 PowerShell 还具有停止分析运算符（--%），它指示它停止解释它之后的任何内容，并只是逐字传递它。
cmd.exe /c "wt.exe" --title tabname1 \; new-tab -p "Ubuntu-18.04" --title tabname2
执行别名在 WSL 分发版中不起作用。 如果要从 WSL 命令行使用 wt.exe，可以通过运行 cmd.exe直接从 CMD 生成它。 该 /c 选项指示 CMD 在运行后终止， \; 正斜杠 + 分号分隔命令。
同一选项卡中的窗格可以具有不同的标题。 选项卡标题反映具有焦点的窗格的标题。 若要命名独立窗格，请通过输入以下命令在拆分窗格后设置标题：
命令提示符
PowerShell
Linux
wt --title pane1 ; split-pane -p "Command Prompt" --title pane2
wt --title pane1 `; split-pane -p "Command Prompt" --title pane2
PowerShell 使用分号 ; 分隔语句。 若要将分号 ; 解释为 wt 命令行参数的命令分隔符，需要使用反引号来转义分号字符。 PowerShell 还具有停止分析运算符（--%），它指示它停止解释它之后的任何内容，并只是逐字传递它。
cmd.exe /c "wt.exe" --title pane1 \; split-pane -p "Command Prompt" --title pane2
执行别名在 WSL 分发版中不起作用。 如果要从 WSL 命令行使用 wt.exe，可以通过运行 cmd.exe直接从 CMD 生成它。 该 /c 选项指示 CMD 在运行后终止， \; 正斜杠 + 分号分隔命令。
使用应用程序标题
若要打开允许应用程序通过发送标题更改消息来设置选项卡标题的新终端实例，请使用 --useApplicationTitle 标志。 若要取消这些消息，请使用 --suppressApplicationTitle 标志。 如果未提供任一参数，终端将使用配置文件的设置。 若要打开标题为tabname且该应用程序不会覆盖的选项卡，请输入：
命令提示符
PowerShell
Linux
wt --title tabname --suppressApplicationTitle
wt --title tabname --suppressApplicationTitle
cmd.exe /c "wt.exe" --title tabname --suppressApplicationTitle
执行别名在 WSL 分发版中不起作用。 如果要从 WSL 命令行使用 wt.exe，可以通过运行 cmd.exe直接从 CMD 生成它。 该 /c 选项指示 CMD 在运行 \; 后终止，反斜杠 + 分号分隔命令。
制表符颜色
若要打开具有自定义选项卡颜色的新终端实例，请使用 --tabColor 参数。 此参数替代配置文件中定义的值，但选项卡颜色选取器也可以替代该值。 在以下示例中，使用两个不同颜色的选项卡创建新的终端：
命令提示符
PowerShell
Linux
wt --tabColor #009999 ; new-tab --tabColor #f59218
wt --tabColor '#009999' `; new-tab --tabColor '#f59218'
PowerShell 使用分号 ; 分隔语句。 若要将分号 ; 解释为 wt 命令行参数的命令分隔符，需要使用反引号来转义分号字符。 PowerShell 还具有停止分析运算符（--%），它指示它停止解释它之后的任何内容，并只是逐字传递它。
cmd.exe /c "wt.exe" --tabColor #009999 \; new-tab --tabColor #f59218
执行别名在 WSL 分发版中不起作用。 如果要从 WSL 命令行使用 wt.exe，可以通过运行 cmd.exe直接从 CMD 生成它。 该 /c 选项指示 CMD 在运行后终止，并 \; 分隔命令。
--tabColor设置选项卡时，将它与此选项卡的第一个窗格相关联。因此，在具有多个窗格的选项卡中，仅当第一个窗格处于焦点时，才会应用颜色。 若要设置其他窗格的选项卡颜色，还需要将 --tabColor 参数添加到 split-pane 子命令。 在下面的示例中，创建了一个包含两个窗格的选项卡，其中为每个窗格指定了选项卡颜色：
wt new-tab --tabColor '#009999' `; split-pane --tabColor '#f59218'
色彩设计
若要打开具有特定配色方案的新终端实例（而不是 colorScheme 配置文件中的集），请使用 --colorScheme 参数。 此参数替代配置文件中定义的值。
命令提示符
PowerShell
Linux
wt --colorScheme Vintage ; split-pane --colorScheme "Tango Light"
wt --colorScheme Vintage `; split-pane --colorScheme "Tango Light"
PowerShell 使用分号 ; 分隔语句。 若要将分号 ; 解释为 wt 命令行参数的命令分隔符，需要使用反引号来转义分号字符。 PowerShell 还具有停止分析运算符（--%），它指示它停止解释它之后的任何内容，并只是逐字传递它。
cmd.exe /c "wt.exe" --colorScheme Vintage \; split-pane --colorScheme "Tango Light"
执行别名在 WSL 分发版中不起作用。 如果要从 WSL 命令行使用 wt.exe，可以通过运行 cmd.exe直接从 CMD 生成它。 该 /c 选项指示 CMD 在运行后终止，并 \; 分隔命令。
Tab 焦点
若要在焦点中打开具有特定选项卡的新终端实例，请使用 -t 标志（或 --target），以及制表符索引号。 若要在第一个选项卡中打开默认配置文件，并将“Ubuntu-18.04”配置文件聚焦在第二个选项卡中（-t 1），请输入：
命令提示符
PowerShell
Linux
wt ; new-tab -p "Ubuntu-18.04" ; focus-tab -t 1
wt `; new-tab -p "Ubuntu-18.04" `; focus-tab -t 1
PowerShell 使用分号 ; 分隔语句。 若要将分号 ; 解释为 wt 命令行参数的命令分隔符，需要使用反引号来转义分号字符。 PowerShell 还具有停止分析运算符（--%），它指示它停止解释它之后的任何内容，并只是逐字传递它。
cmd.exe /c "wt.exe" \; new-tab -p "Ubuntu-18.04" \; focus-tab -t 1
执行别名在 WSL 分发版中不起作用。 如果要从 WSL 命令行使用 wt.exe，可以通过运行 cmd.exe直接从 CMD 生成它。 该 /c 选项指示 CMD 在运行 \; 后终止，反斜杠 + 分号分隔命令。
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 终端）关闭，然后再返回到提示。 此行为不同于命令提示符的行为，该行为会立即返回到提示。
将 Windows 终端可执行文件添加到 PATH
若要将 Windows 终端可执行文件（wt.exe）添加到 PATH，请在 Windows 设置的“ 管理应用执行别名 ”页中启用其“应用执行别名”。 默认情况下，Windows 终端别名处于打开状态，但如果你访问它时遇到问题，可能需要确认它。
如果在访问应用执行别名时遇到问题，请检查 PATH 是否包含： %LOCALAPPDATA%\Microsoft\WindowsApps 不要尝试更改 C:\Program Files\WindowsApps。