可用于 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 终端中选项卡的标题，并且希望该标题保留，则必须通过将它设置为
拆分窗格命令
用于创建新的拆分窗格。 另请参阅作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 的值，请参阅下文 |
接受 direction 的值
-
up、down、left或right移动焦点在给定的方向。 -
first将焦点移动到树中的第一个叶窗格。 -
previous将焦点移动到当前窗格之前最近使用的窗格。 -
nextInOrder，previousInOrder按创建顺序将焦点移动到下一个或上一个窗格。
Move-pane 命令
用于在窗口中移动窗格。 另请参阅作movePane。
| Command | 参数 | Description | 价值观 |
|---|---|---|---|
move-pane、mp |
--tab,-t <index> |
将活动窗格移动到窗口中的给定选项卡 | 要移动到窗格的选项卡的零索引索引。 |
交换窗格命令
用于交换窗口中两个窗格的位置。 另请参阅作swapPane。
| Command | 参数 | Description | 价值观 |
|---|---|---|---|
swap-pane |
<direction> |
将窗格交换为给定方向的窗格 | 有关接受 direction 的值，请参阅下文 |
接受 direction 的值（这些值与 move-focus 子命令相同）
-
up、down、left或right：将活动窗格与给定方向的窗格交换。 -
first：将活动窗格与树中的第一个叶窗格交换。 -
previous：将活动窗格与当前窗格之前最近使用的窗格交换。 -
nextInOrder，previousInOrder：按创建顺序将活动窗格与下一个或上一个窗格交换。
命令行参数示例
根据所使用的命令行，命令可能会略有不同。
将参数传递给默认 shell
若要启动 Windows 终端的实例并让其执行命令，请调用 wt.exe 后跟命令。
下面是调用 Windows 终端以传递 ping 命令参数以回显 IP 地址的示例：
wt ping free.blessedness.top
下面是一个示例：调用 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 终端的现有（已打开）实例中打开新的 shell 选项卡，请使用：wt -w 窗口 ID [可执行文件名称]。 例如， wt -w 0 cmd 若要在 Windows 终端的最新实例中打开命令提示符 shell。 如果要启动配置文件（shell 可执行文件与配色方案、标题、命令、与主机会话交互方式相关的其他设置），则必须在命令中使用配置文件名称： wt -w 0 -p "Profile Name"
目标目录
若要指定应用作控制台起始目录的文件夹，在本例中为 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-tab可以对命令split-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"
Tab 焦点
若要在焦点中打开具有特定选项卡的新终端实例，请使用 -t 标志（或 --target），以及制表符索引号。 若要在第一个选项卡中打开默认配置文件，并将“Ubuntu-18.04”配置文件聚焦在第二个选项卡中（-t 1），请输入：
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 终端）关闭，然后再返回到提示。 请注意，这不同于命令提示符的行为，该行为将立即返回到提示。
将 Windows 终端可执行文件添加到 PATH
若要将 Windows 终端可执行文件（wt.exe）添加到 PATH，请在 Windows 设置的“ 管理应用执行别名 ”页中启用其“应用执行别名”。 默认情况下，Windows 终端别名处于打开状态，但如果你访问它时遇到问题，可能值得确认。
如果在访问应用执行别名时遇到问题，可能需要检查 PATH 是否包含： %LOCALAPPDATA%\Microsoft\WindowsApps 不要尝试更改 C:\Program Files\WindowsApps。
