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