Windows 終端機的外觀設定檔設定

發行項
10/29/2024

下列設定會分別影響各個設定檔的視覺設定。如果您想將某項設定套用至您所有設定檔，可以將該設定新增至 settings.json 檔案中設定檔清單上方的 defaults 區段。

"defaults":
{
    // SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
    // PROFILE OBJECTS
]

Text

色彩配置

這是設定檔中所使用色彩配置的名稱。色彩配置是在 schemes 物件中定義。如需詳細資訊，請參閱色彩配置頁面。

除了單一色彩配置名稱外，這個屬性也接受成對的色彩配置名稱，如下所示：

"colorScheme":
{
    "light": "One Half Light",
    "dark": "One Half Dark",
},

若以這種方式指定色彩，終端機會根據應用程式的主題，在兩個指定色彩配置之間切換。終端機會遵循終端機所選主題的 theme.applicationTheme (機器翻譯) 屬性。如果 applicationTheme 設定為 system，則會改用符合作業系統主題的色彩配置。

屬性名稱：colorScheme

必要性: 選用

接受：字串形式的色彩配置名稱，或具有 light 與 dark 屬性的物件

預設值："Campbell"

Font

必須在這個結構中定義其他字型設定。在 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": {
    "face": "Cascadia Mono",
    "size": 12,
    "weight": "normal"
}

重要

font 物件僅適用於 Windows 終端機 1.10 以上版本，在較舊的版本中，必須分別使用 fontFace、fontSize 與 fontWeight 屬性，如下所示：

"fontFace": "Cascadia Mono",
"fontSize": 12,
"fontWeight": "normal"

字型特徵

用於為指定字型設定 OpenType 字型特徵 (英文)。

屬性名稱： features （定義於物件內 font ）

必要性: 選用

接受：以下格式的特徵屬性："string": integer

範例：

// Enables ss01 and disables ligatures
"font": {
    "face": "Cascadia Code",
    "features": {
        "ss01": 1,
        "liga": 0
    }
}

字型軸

用於為指定字型設定 OpenType 字型軸 (英文)。

屬性名稱： axes （定義於物件內 font ）

必要性: 選用

接受：以下格式的軸屬性："string": integer

範例：

// Sets the font to italic
"font": {
    "face": "Cascadia Code",
    "axes": {
        "ital": 1
    }
}

強調文字格式設定

用於控制終端機中的「強調」文字格式。「強調」文字是以逸出序列 \x1b[1m 指定格式的文字。

屬性名稱：intenseTextStyle

必要性: 選用

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

"all"：以鮮明粗體呈現強調文字
"bold"：以非鮮明粗體呈現強調文字
"bright"：以鮮明非粗體呈現強調文字
"none"：終端機不會以任何特別方式呈現強調文字

預設值："bright"

懷舊終端機效果

當這個項目設定為 true 時，終端機會模擬具有掃描線和模糊文字邊緣的傳統 CRT 顯示器。這是實驗性功能，並不保證其持續存在。

如果您設定了 experimental.pixelShaderPath，此設定會受到覆寫。

屬性名稱：experimental.retroTerminalEffect

必要性: 選用

接受：true、false

預設值：false

Windows 終端機實驗性復古終端效果設定：懷舊命令提示字元 (機器翻譯)

資料指標

游標圖形

這會設定設定檔的游標圖形。可能的游標如下所示："bar" (┃)、"vintage" (▃)、"underscore" (▁)、"filledBox" (█)、"emptyBox" (▯), "doubleUnderscore" (‗)

屬性名稱：cursorShape

必要性: 選用

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

預設值："bar"

游標高度

這會設定從底部開始的游標百分比高度。只有當 cursorShape 設定為 "vintage" 時，才有作用。

屬性名稱：cursorHeight

必要性: 選用

接受：1 至 100 的整數

背景影像和圖示

Windows 終端機可讓您使用設定 UI 功能表或 settings.json 檔案，為每個命令列設定檔指定自訂背景影像和圖示，讓您分別為各個設定檔進行設定/加上商標/指定樣式。若要設定背景影像和圖示，請指定您偏好的 backgroundImage，使用 backgroundImageAlignment 決定位置，透過 backgroundImageOpacity 設定不透明度，以及/或者利用 backgroundImageStretchMode 指定影像在可用空間中的填滿效果。

例如：

    "backgroundImage": "C:\\Users\\username\\OneDrive\\WindowsTerminal\\bg-ubuntu-256.png",
    "backgroundImageAlignment": "bottomRight",
    "backgroundImageOpacity": 0.1,
    "backgroundImageStretchMode": "none"

只要將圖示和影像儲存在 OneDrive 中，就能輕鬆在所有電腦上的影像和圖示集合中漫遊 (如上所示)。

背景影像路徑

這會設定要在視窗背景上繪製的影像檔案位置。背景影像可以是 .jpg、.png 或 .gif 檔案。 "desktopWallpaper" 會將背景影像設定為電腦桌布。

屬性名稱：backgroundImage

必要性: 選用

接受：字串形式的檔案位置或 "desktopWallpaper"

建議將自訂影像和圖示儲存在系統提供的資料夾中，然後使用正確的 URI 配置 (機器翻譯) 參考。 URI 配置可以不同於實體路徑 (日後可能會變更) 的方式連結至參考檔案。自訂背景影像和圖示時，需要記住的最實用 URI 配置如下：

URI 配置	對應的實體路徑	使用/描述
`ms-appdata:///Local/`	`%localappdata%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\`	每部電腦的檔案
`ms-appdata:///Roaming/`	`%localappdata%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState\`	通用檔案

警告

請勿依賴使用 ms-appx URI 配置的檔案參考 (亦即圖示)。這類檔案被視為內部實作詳細資料，日後可能會變更名稱/位置，或遭到省略。

圖示

Windows 終端機會針對終端機為任何內建殼層 (例如 PowerShell Core、PowerShell 和所有已安裝的 Linux/WSL 散發套件) 產生的設定檔顯示圖示。每個設定檔都會透過 ms-appx URI 配置參考一個庫存圖示。您可以在 settings.json 檔案中輸入路徑，以參考您自己的自訂圖示：

    "icon" : "C:\\Users\\username\\OneDrive\\WindowsTerminal\\icon-ubuntu-32.png",

圖示的大小應為 32 x 32px，並採用適當點陣影像格式 (例如 .PNG、.GIF 或 .ICO)，以免在執行階段必須調整圖示 (會造成明顯延遲和畫質降低)。

如未替已安裝的命令列指定圖示，Windows 終端機會將其預設為 Segoe Fluent (機器翻譯) 字型的以下圖像：

圖像	Unicode 點	描述
	e756	CommandPrompt

背景影像延展模式

這會設定背景影像調整大小以填滿視窗的方式。

屬性名稱：backgroundImageStretchMode

必要性: 選用

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

預設值："uniformToFill"

Windows 終端機背景影像延展模式背景影像來源 (英文)

背景影像對齊

這會設定背景影像與視窗界限對齊的方式。

屬性名稱：backgroundImageAlignment

必要性: 選用

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

預設值："center"

Windows 終端機背景影像對齊方式背景影像來源 (英文)

背景影像不透明度

這會設定背景影像的透明度。

屬性名稱：backgroundImageOpacity

必要性: 選用

接受：0-1 的浮點數值

預設值：1.0

透明

不透明度

用於為設定檔指定視窗透明度，接受 0-100 的整數值，表示「不透明百分比」。 100 代表「完全不透明」，50 代表半透明，0 則代表完全透明。

若將 useAcrylic 設定為 true，視窗會使用壓克力材質為終端機建立模糊背景。當設定為 false 時 useAcrylic ，終端機會使用未模糊的不透明度。

用戶可以針對焦點和未對焦視窗選擇不同的不透明度值，以允許自定義。

屬性名稱：opacity

必要性: 選用

接受： 數位為 0-100 的整數值

預設值：100

Windows 終端機壓克力不透明度

重要

在 Windows 終端機 1.12 之前的版本中，此設定為 acrylicOpacity，是接受 0.0-1.0 的浮點數，預設值為 0.5，且只有在 useAcrylic 設定為 true 時才會套用不透明度。在 1.12 以後的版本中，acrylicOpacity 照常是對等的 opacity 值。

重要

非模糊不透明度 ("useAcrylic": false) 僅適用於 Windows 11。

重要

在主題設定 (機器翻譯) 中啟用 Mica 後，只要將終端機的 opacity 設定設為 <100，Mica 就會出現在終端機內容下方。

啟用壓克力

當這個項目設定為 true 時，視窗會有壓克力背景。當其設定為 false 時，視窗將會有平面、無紋理的背景。根據 Enable Unfocused Acrylic 全域設定，透明度會套用至未對焦的視窗，如同設定為 true 時的焦點視窗，或只在設定 false為時套用至焦點視窗。

屬性名稱：useAcrylic

必要性: 選用

接受：true、false

預設值：false

updated_acrylic_toggle_doc

視窗

邊距

這會設定視窗中文字周圍的填補。接受三種不同的格式："#" 與 # 會為每一側設定相同的填補，"#, #" 會為左右、上下分別設定相同的填補，"#, #, #, #" 會針對左側、頂端、右側和底部分別設定填補。

屬性名稱：padding

必要性: 選用

接受：採用下列格式的字串值："#"、"#, #"、"#, #, #, #" 或整數值：#

預設值："8, 8, 8, 8"

Windows 終端機填補

捲軸可見度

這會設定捲軸的可見度。

屬性名稱：scrollbarState

必要性: 選用

接受："visible"、"hidden"、（從 1.17 版開始，"always"將包含）

色彩設定

索引標籤色彩

用於為設定檔的索引標籤設定色彩。若使用索引標籤色彩選擇器，會覆寫此色彩。

屬性名稱：tabColor

必要性: 選用

接受：十六進位格式字串形式的色彩："#rgb" 或 "#rrggbb"

前景色彩

這會變更設定檔的前景色彩。如果已設定 colorScheme，這會覆寫色彩配置中所設定的 foreground。

屬性名稱：foreground

必要性: 選用

接受：十六進位格式字串形式的色彩："#rgb" 或 "#rrggbb"

背景色彩

這會使用這項設定來變更設定檔的背景色彩。如果已設定 colorScheme，這會覆寫色彩配置中所設定的 background。

屬性名稱：background

必要性: 選用

接受：十六進位格式字串形式的色彩："#rgb" 或 "#rrggbb"

選取範圍背景色彩

這會設定設定檔內選取範圍的背景色彩。如果已設定 colorScheme，這會覆寫色彩配置中所設定的 selectionBackground。

屬性名稱：selectionBackground

必要性: 選用

接受：十六進位格式字串形式的色彩："#rgb" 或 "#rrggbb"

調整無法區分的色彩

這項設定會根據背景色彩調整前景色彩，使前景色彩更清晰可見。若設定為 always，一律會調整色彩。若設定為 indexed，只有在色彩屬於色彩配置的一部分時才會調整色彩。若設定為 never，則一律不會調整色彩。

屬性名稱：adjustIndistinguishableColors

必要性: 選用

接受：always、indexed、never

游標色彩

這會設定設定檔的游標色彩。如果已設定 colorScheme，這會覆寫色彩配置中所設定的 cursorColor。

屬性名稱：cursorColor

必要性: 選用

接受：十六進位格式字串形式的色彩："#rgb" 或 "#rrggbb"

未取得焦點的外觀設定

您可以在設定檔中新增這個物件，替未取得焦點的設定檔套用設定。這項設定只接受外觀設定。

屬性名稱：unfocusedAppearance

必要性: 選用

接受：、、、、、、backgroundImageuseAcrylicbackgroundImageAlignmentexperimental.retroTerminalEffectselectionBackgroundbackgroundImageStretchModecursorColorcursorShapecolorSchemeopacityforegroundcursorHeightbackgroundImageOpacitybackgroundexperimental.pixelShaderPath

範例：

// Sets the profile's background image opacity to 0.3 when it is unfocused
"unfocusedAppearance":
{
    "backgroundImageOpacity": 0.3
},

像素著色器效果

這項設定可讓使用者指定要與終端機內容搭配使用的自訂像素著色器路徑。這是實驗性功能，並不保證其持續存在。如需詳細瞭解如何為終端機撰寫自訂像素著色器，請參閱這份文件 (英文)。

若指定了這項設定，便會覆寫 experimental.retroTerminalEffect 設定。

屬性名稱：experimental.pixelShaderPath

必要性: 選用

接受：採字串形式的 .hlsl 著色器檔案路徑

共用方式為

Windows 終端機的外觀設定檔設定

Text

色彩配置

Font

字體

字型大小

字型粗細

字型範例

字型特徵

字型軸

強調文字格式設定

懷舊終端機效果

資料指標

游標圖形

游標高度

背景影像和圖示

背景影像路徑

圖示

背景影像延展模式

背景影像對齊

背景影像不透明度

透明

不透明度

啟用壓克力

視窗

邊距

捲軸可見度

色彩設定

索引標籤色彩

前景色彩

背景色彩

選取範圍背景色彩

調整無法區分的色彩

游標色彩

未取得焦點的外觀設定

像素著色器效果

其他資源