无论配置文件设置如何,下面列出的属性都将影响整个终端窗口。 这些应放在 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