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