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

必要性: 可选

接受:truefalse

默认值: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

必要性: 可选

接受:truefalse

默认值:false



禁用动态配置文件

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

属性名称:disabledProfileSources

必要性: 可选

接受:"Windows.Terminal.Wsl""Windows.Terminal.Azure""Windows.Terminal.PowershellCore"和/或"Windows.Terminal.SSH"数组内部

默认值:[]



启动操作

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

属性名称:startupActions

必要性: 可选

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

默认值:""



继续在后台运行(预览

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

属性名称:compatibility.allowHeadless

必要性: 可选

接受:truefalse

默认值:false