Windows 终端命令行参数

分类: 365bet手机app下载 发布时间: 2025-08-27 23:16:58 作者: admin 阅读: 6212

可用于 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。