Windows 终端（预览版）中的主题设置

下面列出的设置会影响终端窗口本身的视觉效果，而不是单个选项卡/窗格的外观。 目前只能在 settings.json file 中直接编辑这些设置，无法通过设置 UI 对其进行配置。

"theme": "dark"
"themes":
[
    // THEME OBJECTS
]

有关一些示例主题，请查看主题库。

themes 列表中的每个主题都由一组属性对象组成，这些对象指定应用程序的各个元素的属性。 例如，默认 "dark" 主题如下所示：

{
    "name": "dark",
    "window": {
        "applicationTheme": "dark"
    },
    "tab": {
        "background": "terminalBackground",
        "unfocusedBackground": "#00000000"
    },
    "tabRow": {
        "unfocusedBackground": "#333333FF"
    }
},

还可将终端配置为在操作系统中对浅色模式和深色模式使用单独的主题，并在操作系统主题更改时自动在这些主题之间切换。 为此，请将 theme 属性指定为包含 light 和 dark 键的对象：

"theme": { "dark": "<Dark Theme Name>", "light": "<Light Theme Name>" },

主题名称

这是主题的名称。 名称应该是唯一的。 名称 dark、light 和 system 保留为内置默认主题。

属性名称：name

必要性： 必需

接受：作为字符串的主题名称

---

窗口

这些设置用于配置终端整个窗口的外观。

属性名称：window

应用程序主题

这将设置应用程序的 UI 主题。 这将风格化按钮、命令面板和其他应用程序 UI 元素等项。 可以是浅色或深色。 "system" 将使用与 Windows 相同的主题。

属性名称：applicationTheme

必要性： 可选

接受："system"、"dark"、"light"

默认值："dark"

Mica

这会在此窗口的所有其他 UI 层下启用 Mica 效果。 要使 Mica 可见，其上方的层需要是透明的。 例如，要在选项卡行中实现 Mica，需要将背景的 alpha 通道配置为 0，如下所示：

{
    "name": "My Mica Theme",
    "tab":
    {
        "background": "terminalBackground"
    },
    "tabRow":
    {
        "background": "#00000000"
    },
    "window":
    {
        "applicationTheme": "system",
        "useMica": true
    }
},

请注意，为窗口启用 Mica 时，它将在整个窗口下启用，包括作为窗口中终端窗格的背景。 这意味着使用 opacity 但未启用 useAcrylic 的配置文件将以新的 Mica 背景显示。 目前不能同时为终端提供清晰透明背景，为选项卡/选项卡行提供 Mica 背景。

属性名称：useMica

必要性： 可选

接受：true、false

默认值：false

注意

Mica 仅在 Windows >= 22621 版本中可用。

窗口边框

这会在窗口处于活动状态时设置窗口边框的颜色。 设置为 null 时，边框将使用 OS 主题的默认颜色。

属性名称：frame

必要性： 可选

接受：主题颜色

默认值：null

注意

窗口边框颜色仅在 Windows 11 上提供。

重要

此功能仅在 Windows 终端预览中可用。

非活动窗口边框

这会在窗口处于非活动状态时设置窗口边框的颜色。 设置为 null 时，边框将使用 OS 主题的默认颜色。

属性名称：unfocusedFrame

必要性： 可选

接受：主题颜色

默认值：null

重要

此功能仅在 Windows 终端预览中可用。

试验性：彩虹窗口边框

启用后，此设置会使窗口边框循环显示彩虹的颜色。 这是一个试验性功能，我们不保证它会持续存在。 启用此设置后，它将优先于 frame 和 unfocusedFrame。

属性名称：experimental.rainbowFrame

必要性： 可选

接受：true、false

默认值：false

重要

此功能仅在 Windows 终端预览中可用。

---

选项卡行

这些设置用于配置选项卡行的外观。 当 showTabsInTitlebar 为 true 时（默认值），这会配置标题栏。

属性名称：tabRow

背景色

窗口为前景色时选项卡行的颜色。

属性名称：background

必要性： 可选

接受：主题颜色。

非活动背景色

窗口处于非活动状态时选项卡行的颜色。

属性名称：unfocusedBackground

必要性： 可选

接受：主题颜色。

---

制表符

这些设置可控制终端中各个选项卡的外观。

属性名称：tab

背景色

活动选项卡的颜色。在配置文件中设置 tabColor 将覆盖此值。 同样，在运行时使用选项卡颜色选取器设置颜色将覆盖此颜色。

即使设置为具有亚克力背景的窗格的 terminalBackground，此颜色也始终被视为纯色。

属性名称：background

必要性： 可选

接受：主题颜色。

非活动背景色

非活动选项卡的颜色。 在配置文件中设置 tabColor 将覆盖此值。 同样，在运行时使用选项卡颜色选取器设置颜色将覆盖此颜色。

即使设置为具有亚克力背景的窗格的 terminalBackground，此颜色也始终被视为纯色。

设置为 terminalBackground 或 accent 时，这将自动使用 Alpha 值 30% 以变为半透明。

属性名称：unfocusedBackground

必要性： 可选

接受：主题颜色。

显示“关闭”按钮

配置在选项卡上显示“关闭”按钮的方式。 这会接受以下值：

• "always"：始终显示选项卡“关闭”按钮。
• "hover"：在活动选项卡以及鼠标悬停在其上的任何选项卡上显示“关闭”按钮。
• "never"：从不显示选项卡“关闭”按钮。 这还会禁用使用鼠标中键关闭选项卡的功能。
• "activeOnly"：仅在活动选项卡上显示选项卡关闭按钮。

属性名称：showCloseButton

必要性： 可选

接受："always"、"hover"、"never"、"activeOnly"

默认值："always"

---

主题颜色

主题中使用的颜色接受 RGBA 颜色值以及表示自定义值的少数特殊字符串。 接受的值如下所示：

• "#rgb、"#rrggbb、"#rrggbbaa：RGB 颜色值。 如果省略 Alpha 通道，则这些颜色默认为完全不透明的 Alpha 通道。
• "accent"：这是一个特殊值，表示“系统设置中的主题色设置”。
• "terminalBackground"：这是一个特殊值，其计算结果表示“活动终端窗格的背景色”。 如果选项卡中有多个窗格，则该值是活动窗格的颜色。 该值始终使用配置文件的 background - 它将忽略任何来自 backgroundImage的任何内容（如果已设置）。