可用于 wt.exe 从命令行打开 Windows 终端的新实例。 还可以改用执行别名 wt 。
注释
如果从 GitHub 上的源代码生成 Windows 终端,则可以使用 wtd.exe 或 wtd打开该生成。
命令行语法
wt命令行接受两种类型的值:选项和命令。
选项 是标志和其他参数的列表,可以控制整个命令行的行为 wt 。
命令 提供应实现的作或用分号分隔的作列表。 如果未指定任何命令,则默认假定该命令。new-tab
wt [options] [command ; ]
注释
该命令的行为 wt.exe 可能会受到 windowingBehavior 属性的影响。 可以在打开新窗口或打开新选项卡之间将此设置调整为默认值。
若要显示列出可用命令行参数的帮助消息,请输入: 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 窗口 ID [可执行文件名称]。 例如, 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 ,它将与此选项卡的第一个窗格相关联。因此,在具有多个窗格的选项卡中,仅当第一个窗格处于焦点时,才会应用颜色。 若要设置其他窗格的选项卡颜色,还需要将参数添加到--tabColorsplit-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。