Windows 终端中的启动设置

  • 项目

无论配置文件设置如何，下面列出的属性都将影响整个终端窗口。 这些应放在 settings.json 文件的根目录下。

默认配置文件

设置打开的默认配置文件，方法是键入 Ctrl+Shift+T，键入分配给 newTab 的键绑定，运行 wt new-tab（未指定配置文件），或者单击“+”图标。

属性名称：defaultProfile

必要性： 必需

接受： 字符串形式的 GUID 或配置文件名称

默认值： PowerShell 的 GUID


默认终端应用程序

在 Windows 中设置默认终端模拟器，使所有命令行应用程序在其中运行。

属性名称：这会修改 OS 设置并且在 settings.json 文件中没有属性名称。

必要性： 必需

接受：下拉列表中显示的任何终端模拟器

默认值：Windows 控制台主机

重要

此功能仅在运行 Windows 10 Insider Program Dev Channel 或 Windows 11 时可用。


在计算机启动时启动

如果设置为 true，会在计算机启动时启动 Windows 终端。 如果将其设置为 false，会禁用启动任务项。

注意：如果组织策略或用户操作禁用了 Windows 终端启动任务项，则此设置不起作用。

属性名称：startOnUserLogin

必要性： 可选

接受：true、false

默认值：false


启动新终端会话时的行为

设置为 "defaultProfile" 时，Windows 终端将通过打开具有默认配置文件的单个选项卡来启动新会话。

当设置为 "persistedWindowLayout" 时，Windows 终端便能够在关闭时保存打开窗口的布局，并在启动新会话时恢复所有保存的窗口。 Windows 终端将自动保存所有打开窗口的布局以帮助从崩溃中恢复，并且在使用 quit 操作时也会保存布局。 此外，通过单击 X 按钮或使用 closeWindow 命令关闭最后一个打开的窗口将保存最后一个窗口的布局。

注意：目前 Windows 终端会保存以下信息：

  • 每个窗口的位置、大小和名称

  • 每个窗口的选项卡布局，包括每个窗格的布局和配置文件，但不包括这些窗格的任何内容

  • 如果 shell 配置为要报告同样要保存的当前工作目录

属性名称：firstWindowPreference

必要性： 可选

接受："defaultProfile"、"persistedWindowLayout"

默认值："defaultProfile"


启动模式

这将定义终端在启动时将采用最大化、全屏还是窗口形式。 将其设置为 focus 相当于在 default 模式下启动终端，但启用了焦点模式。 同样，将其设置为 maximizedFocus 将导致在最大化窗口中启动终端（已启用焦点模式）。

属性名称：launchMode

必要性： 可选

接受："default"、"maximized"、"fullscreen"、"focus"、"maximizedFocus"

默认值："default"


新实例行为

此设置控制新终端实例如何附加到现有窗口。 仅当未提供--window,-w window命令行参数时才使用此属性。 此设置接受以下可能值：

  • useNew始终创建新窗口。 这就是终端在 1.7 版本之前惯常的行为方式。
  • useExisting：在此桌面上最近使用的窗口中创建新选项卡。 如果该虚拟桌面上没有现有窗口，则创建一个新的终端窗口。
  • useAnyExisting：在最近使用的窗口中创建新选项卡，无论该窗口位于哪个虚拟桌面上。

属性名称：windowingBehavior

必要性： 可选

接受："useNew"、"useExisting"、"useAnyExisting"

默认值："useNew"


启动大小

首次启动时的列

这是首次加载时窗口中显示的字符列数。 如果将 launchMode 设置为 "maximized" 或 "maximizedFocus"，将忽略此属性。

属性名称：initialCols

必要性： 可选

接受： 整数

默认值：120

首次启动时的行

这是首次加载时窗口中显示的行数。 如果将 launchMode 设置为 "maximized" 或 "maximizedFocus"，将忽略此属性。

属性名称：initialRows

必要性： 可选

接受： 整数

默认值：30


启动位置

这将设置首次加载时窗口左上角的像素位置。 在具有多个显示器的系统上，这些坐标相对于主显示器的左上角。 如果未提供 X 或 Y 坐标，则终端将为该值使用系统默认值。 如果 launchMode 设置为 "maximized" 或 "maximizedFocus"，则窗口将在由这些坐标指定的监视器上以最大化方式显示。

属性名称：initialPosition

必要性： 可选

接受： 采用以下格式的字符串形式的坐标：","、"#,#"、"#,"、",#"

默认值：","


启动时居中

当设置为 true 时，终端窗口将在其打开的显示器上自动居中。 终端将使用 "initialPosition" 来确定要在哪个显示器上打开。

这通过以下方式与其他启动设置交互：

  • "initialPosition": "x,y"、"centerOnLaunch": true、"launchMode": "default"：在 x,y 所在的监视器上居中。
  • "initialPosition": "x,y"、"centerOnLaunch": true、"launchMode": "maximized"：在 x,y 所在的监视器上最大化（centerOnLaunch 不添加任何内容）。
  • "initialPosition": <omitted>、"centerOnLaunch": true、"launchMode": "default"：在默认监视器上居中。
  • "initialPosition": <omitted>、"centerOnLaunch": true、"launchMode": "focus"：在默认监视器上居中并进入焦点模式。
  • "initialPosition": <omitted>、"centerOnLaunch": true、"launchMode": "maximized"：在默认监视器上最大化（centerOnLaunch 不添加任何内容）。

属性名称：centerOnLaunch

必要性： 可选

接受：true、false

默认值：false


禁用动态配置文件

这会设置禁用哪些动态配置文件生成器，从而阻止它们在启动时将其配置文件添加到配置文件列表中。 有关动态配置文件的信息，请访问动态配置文件页。

属性名称：disabledProfileSources

必要性： 可选

接受：数组中的 "Windows.Terminal.Wsl"、"Windows.Terminal.Azure"、"Windows.Terminal.PowershellCore" 和/或 "Windows.Terminal.SSH"

默认值：[]


启动操作

这将设置在启动时执行的操作列表，从而允许终端在默认情况下使用一组自定义的选项卡和窗格启动。 仅当未提供命令行参数时，才会应用这些操作。 操作列表用与命令行参数中的命令格式相同的字符串表示。 有关命令格式的详细信息，请访问命令行参数页。

属性名称：startupActions

必要性： 可选

接受：表示要运行的命令列表的字符串

默认值：""


继续在后台运行（预览）

如果设置为 true，则终端能够在最后一个窗口关闭后继续在后台运行。 这样，即使没有打开任何窗口，globalSummon 和 quake 模式也能正常工作。 此设置仅在终端的预览版中可用。

属性名称：compatibility.allowHeadless

必要性： 可选

接受：true、false

默认值：false