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