Windows 終端機中的主題設定 (預覽)

下列設定會影響終端機視窗本身的視覺效果，而不是個別索引標籤/窗格的外觀。 這些設定目前只能在 settings.json 檔案中直接編輯，而且無法透過設定 UI 進行設定。

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

如需一些範例主題，請參閱主題資源庫。

themes 清單中的每個主題，都是由屬性物件的集合所組成，這些物件會指定應用程式個別元素的屬性。 例如，預設的 "dark" 主題如下：

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

您也可以將終端機設定為使用個別主題來對應 OS 中的淺色和深色模式，並且在 OS 主題變更時自動變更這些主題。 若要這麼做，請將 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 可見，其上方的 UI 層必須為透明。 例如，若要在其中使用含有 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 時，這會自動使用 30% 的 Alpha 值，以變成半透明。

屬性名稱:unfocusedBackground

必要性: 選用

接受：主題色彩。

顯示關閉按鈕

設定索引標籤上的 [關閉] 按鈕顯示方式。 接受下列的值：

• "always"：一律顯示索引標籤關閉按鈕。
• "hover"：在使用中的索引標籤顯示索引標籤關閉按鈕，其他索引標籤則在滑鼠停留時才顯示。
• "never"：永不顯示索引標籤關閉按鈕。 這也會停用透過滑鼠中間按鈕關閉索引標籤的功能。
• "activeOnly"：僅在使用中的索引標籤顯示索引標籤關閉按鈕。

屬性名稱:showCloseButton

必要性: 選用

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

預設值："always"

---

佈景主題色彩

在主題中使用的色彩都接受 RGBA 色彩值，以及一些自訂值的特殊字串。 接受的值如下：

• "#rgb、"#rrggbb、"#rrggbbaa：RGB 色彩值。 若省略 Alpha 色板，這些色彩預設為完全不透明的 Alpha 色板。
• "accent"：此為特殊值，表示「系統設定中設定的輔色集」。
• "terminalBackground"：此為特殊值，經評估以表示「使用中終端機窗格的背景色彩」。 如果索引標籤中有多個窗格，則這是使用中窗格的色彩。 這一律會使用設定檔的 background，並忽略 backgroundImage 的任何內容 (如有設定)。