Windows 终端外观配置文件设置

下面列出的设置分别影响每个配置文件的视觉设置。 如果希望将某个设置应用于所有配置文件，可以将其添加到 settings.json 文件中的配置文件列表上方的 defaults 部分。

这是配置文件中使用的配色方案名称。 配色方案是在 schemes 对象中定义的。 可以在配色方案页上找到更详细的信息。

除了单个配色方案名称外，此属性还可以接受一对配色方案名称，如下所示：

以这种方式指定时，终端将根据应用程序的主题在两种给定的配色方案之间自动切换。 终端将遵循终端所选主题的 theme.applicationTheme 属性。 如果 applicationTheme 设置为 system，则会改用与操作系统主题匹配的配色方案。

属性名称：colorScheme

必要性： 可选

接受：字符串形式的配色方案名称，或具有 light 和 dark 属性的对象

默认值："Campbell"

重要

仅可在 Windows 终端预览版中指定一对 light 和 dark 配色方案。

必须在此结构中定义其他字体设置。 下面的示例显示了这在 JSON 文件中的效果。

属性名称：font

必要性： 可选

这是配置文件中使用的字体名称。 如果找不到或无效，终端将尝试回退到 Consolas。 若要了解默认字体 (Cascadia Mono) 的其他变体，请访问 Cascadia Code 页。

属性名称：face（在 font 对象中定义）

必要性： 可选

接受： 字符串形式的字体名称。

默认值："Cascadia Mono"

这将设置配置文件的字体大小（以磅为单位）。

属性名称：size（在 font 对象中定义）

必要性： 可选

接受： 整数

默认值：12

此属性设置配置文件字体的粗细（笔画的粗细）。

属性名称：weight（在 font 对象中定义）

必要性： 可选

接受："normal"、"thin"、"extra-light"、"light"、"semi-light"、"medium"、"semi-bold"、"bold"、"extra-bold"、"black"、"extra-black"，或与 OpenType 字体粗细的数值表示形式相对应的整数

默认值："normal"

重要

此 font 对象仅在 Windows 终端预览版版本 1.10+ 中可用。 在该版本之前，应分别使用 fontFace、fontSize 和 fontWeight 属性，如下所示：

这将为给定字体设置 OpenType 字体功能。

属性名称：features（在 font 对象中定义）

必要性： 可选

接受："string": integer 格式的功能属性

示例：

这将为给定字体设置 OpenType 字体轴。

属性名称：axes（在 font 对象中定义）

必要性： 可选

接受："string": integer 格式的轴属性

示例：

这控制“密集”文本在终端中设置的格式设置。 “密集”文本是使用转义序列 \x1b[1m 格式化的文本。

属性名称：intenseTextStyle

必要性： 可选

接受："none"、"bold"、"bright"、"all"

默认值："all"

如果设置为 true，则终端将模拟具有扫描线和模糊文本边缘的经典 CRT 显示。 这是一个试验性功能，我们不保证它会持续存在。

如果设置了 experimental.pixelShaderPath，它将替代此设置。

属性名称：experimental.retroTerminalEffect

必要性： 可选

接受：true、false

默认值：false

配置：怀旧式命令提示符

这将设置配置文件的光标形状。 可能的光标如下："bar"( ┃ )、"vintage"( ▃ )、"underscore"( ▁ )、"filledBox"( █ )、"emptyBox"( ▯ )、"doubleUnderscore"( ‗ )

属性名称：cursorShape

必要性： 可选

接受："bar"、"vintage"、"underscore"、"filledBox"、"emptyBox"、"doubleUnderscore"

默认值："bar"

这会设置光标的百分数高度（从底部开始）。 只有将 cursorShape 设置为 "vintage" 时，此操作才有效。

属性名称：cursorHeight

必要性： 可选

接受：1-100 的整数

通过 Windows 终端，可使用设置 UI 菜单或 settings.json 文件为每个命令行配置文件指定自定义背景图像和图标，从而可以单独配置每个配置文件或设置其品牌/样式。 为此，请指定首选 backgroundImage，使用 backgroundImageAlignment 定位它，使用 backgroundImageOpacity 设置其不透明度，并/或使用 backgroundImageStretchMode 指定图像如何填充可用空间。

例如：

可以将图标和图像存储在 OneDrive 中（如上所示），以便在所有计算机中轻松漫游图像和图标集合。

这将设置要在窗口背景上绘制的图像的文件位置。 背景图像可以是 .jpg、.png 或 .gif 文件。 "desktopWallpaper" 将背景图像设置为桌面壁纸。

属性名称：backgroundImage

必要性： 可选

接受：字符串形式的文件位置或 "desktopWallpaper"

建议将自定义图像和图标存储在系统提供的文件夹中，并使用正确的 URI 方案引用它们。 URI 方案提供了一种独立于文件物理路径的方式来引用文件（物理路径将来可能会更改）。 自定义背景图像和图标时，需要记住的最有用的 URI 方案包括：

警告

请勿依赖使用 ms-appx URI 方案的文件引用（即图标）。 这些文件被视为内部实现详细信息，可能会更改名称/位置，将来还可能被省略。

Windows 终端显示终端为任何内置 shell 生成的每个配置文件的图标，例如：PowerShell Core、PowerShell 和任何已安装的 Linux/WSL 分发版。 每个配置文件都通过 ms-appx URI 方案引用一个库存图标。 可以通过在 settings.json 文件中输入路径来引用自己的自定义图标：

图标的大小应调整为 32x32px，采用适当的光栅图像格式（例如 .PNG、.GIF 或 .ICO），以免需要在运行时缩放图标（导致明显的延迟和质量损失）。

如果未为已安装的命令行指定任何图标，Windows 终端将默认使用 Segoe Fluent 字体的以下字形：

这将设置如何调整背景图像的大小以填充窗口。

属性名称：backgroundImageStretchMode

必要性： 可选

接受："none"、"fill"、"uniform"、"uniformToFill"

默认值："uniformToFill"

背景图像源

这会设置背景图像与窗口边界对齐的方式。

属性名称：backgroundImageAlignment

必要性： 可选

接受："center"、"left"、"top"、"right"、"bottom"、"topLeft"、"topRight"、"bottomLeft"、"bottomRight"

默认值："center"

背景图像源

这会设置背景图像的透明度。

属性名称：backgroundImageOpacity

必要性： 可选

接受： 0-1 的浮点值的数字

默认值：1.0

这会设置该配置文件的窗口透明度。 这接受 0-100 的整数值，表示“不透明度百分比”。 100 为“完全不透明”，50 为半透明且，0 为完全透明。

当 useAcrylic 设置为 true 时，窗口将使用 acrylic 材料为终端创建模糊背景。 当 useAcrylic 设置为 false 时，终端将使用未模糊的不透明度。

属性名称：opacity

必要性： 可选

接受：0-100 的整数值数字

默认值：useAcrylic 为 false 时则为 100，useAcrylic 为 true 时则为 50。

重要

在 Windows 终端版本 1.12 之前，此设置为 acrylicOpacity，是接受 0.0-1.0 的浮点数（默认值为 0.5），仅当 useAcrylic 设置为 true 时才应用不透明度。 在版本 1.12+ 上，acrylicOpacity 将继续作为等效 opacity 值正常工作。

重要

未模糊的不透明度 ("useAcrylic": false) 仅适用于 Windows 11。

重要

如果在主题设置中启用了 Mica，则当终端的 opacity 设置为