Visual Studio 主題色彩標記

Visual Studio 使用語意色彩標記來定義每個 UI 表面的外觀。這些代幣是 Visual Studio 2026 中引入的 Fluent 設計系統的一部分。每個控制項和表面都不參考特定的十六進位顏色，而是參考一個命名的標記。主題會為這些代幣提供值，整個 IDE 也會相應地更新。

此參考資料列出所有可用的主題色彩標記、其預期用途，以及在明暗與高對比主題中的預設值。在建立自訂主題或在設定中覆蓋單一標記，或透過 主題色彩 編輯器時，請使用此參考資料。

在 Visual Studio 中自訂主題色彩

Visual Studio 2026（18.7）包含產品內主題色彩頁面，可自訂 Fluent 主題色彩標記。使用 編輯主題色彩 指令，或開啟 工具 > 選項 > 環境 > 視覺體驗 > 主題顏色。該頁面以可搜尋的網格列出該主題的代幣。

選擇一個代幣並選擇顏色立即套用變更。你可以重置單一代幣，而不移除其他自訂功能。覆蓋檔會分別儲存在每個主題上，並疊加在所選主題上，因此切換主題也會切換到該主題的覆蓋檔。根據可用的標記，你可以自訂編輯器顏色、工具視窗、shell chrome、分頁標頭、視窗標頭，以及互動狀態（如懸停顏色）。

關於更廣泛的終端使用者外觀設定，請參閱 Visual Studio 中的「更改字型、顏色與主題」。

要分享令牌覆寫，請在 %LOCALAPPDATA%\Microsoft\VisualStudio\18.0_xxxxxxxx\ColorThemes. 檔案名稱必須與主題相符才能覆蓋。例如， dark.json 會覆蓋黑暗主題。重新啟動 Visual Studio 以套用基於檔案的覆蓋功能來對匹配主題。

主題代幣的運作方式

每個符號是一個語意名稱，對應到一個顏色值。代幣分為兩類：

Shell （ShellColors） — 用於常見控制與曲面的標記，源自 Windows 11 Fluent 設計系統。這些是封面按鈕、文字框、背景、邊框、狀態指示器等等。用這些標記來做一般的 UI 樣式設計。
Shell 內部 （ShellInternalColors）— 用於 IDE Chrome 表面的標記，如主視窗、標題列、狀態列及工具視窗標頭。這些是為了主題覆蓋而被開放，但並非用於擴充控制樣式。

色彩值格式

顏色會在格式中 #AARRGGBB 指定（alpha、red、green、blue）。例如，在 #B2FFFFFF 不透明度 ~70% 是白色。

高對比度值是系統色彩指數（例如， 00000008 = WindowText）。 Visual Studio 會在執行時將這些設定解析為使用者目前的高對比色彩方案。

覆寫行為

主題提供的代幣價值是所選主題的基礎值。當使用者在主題色彩編輯器中更改標記時，Visual Studio 會將該值套用到所選主題之上，作為覆蓋層。移除或重置單一覆寫會將代幣恢復到所選主題的基礎值，且不會影響其他覆寫。

貝殼顏色

這些標記用來樣式化 Visual Studio 中常見的控制項和表面。它們遵循與 Windows 11 Fluent 主題資源相同的命名規則。

輔色

標記用於強調色元素，如主按鈕、選取的勾選框和啟用指示器。

語彙基元	Description	淺色	深色	高對比
`AccentFillAlt`	替代口音背景，當需要與預設不同色調時使用	`#FF3F3682`	`#FFD2CCF8`	`0000000D`
`AccentFillDefault`	互動元素、行動呼籲及選定狀態的預設重音背景	`#FF5649B0`	`#FF9184EE`	`0000000D`
`AccentFillDisabled`	身心障礙口音背景	`#37000000`	`#28FFFFFF`	`00000010`
`AccentFillSecondary`	重音背景顯示懸停狀態	`#E55649B0`	`#E59184EE`	`0000000D`
`AccentFillSelectedTextBackground`	活動文字欄位中選取文字的背景	`#FF0078D4`	`#FF005FB7`	`0000000D`
`AccentFillSelectedTextBackgroundSubtle`	細膩選取的文字背景，當前景文字顏色無法反轉時使用	`#4D0078D4`	`#6660CDFF`	`0000000D`
`AccentFillSenary`	大學以外國家的微妙口音背景	`#1F5649B0`	`#1F9184EE`	`0000000E`
`AccentFillTertiary`	重音背景顯示壓制狀態	`#CC5649B0`	`#CC9184EE`	`0000000D`
`AccentTextFillDisabled`	重音符號與字形顏色被停用	`#5C000000`	`#5DFFFFFF`	`00000011`
`AccentTextFillPrimary`	前景文字與需要強調的字形的主要重音符號顏色	`#FF3F3682`	`#FFD2CCF8`	`00000002`
`AccentTextFillSecondary`	強調懸停狀態的重音文字	`#FF221D46`	`#FFD2CCF8`	`00000002`
`AccentTextFillTertiary`	強調按鍵狀態的重音文字	`#FF5649B0`	`#FFA79CF1`	`00000002`

卡片

用於卡片狀表面的代幣——位於頁面或圖層背景上的內容區塊。

語彙基元	Description	淺色	深色	高對比
`CardBackgroundFillDefault`	預設卡牌背景	`#B2FFFFFF`	`#0DFFFFFF`	`00000005`
`CardBackgroundFillSecondary`	顯示懸停狀態的卡片背景	`#80F6F6F6`	`#08FFFFFF`	`00000005`
`CardBackgroundFillTertiary`	顯示已按下狀態的卡片背景	`#FFFFFFFF`	`#12FFFFFF`	`00000005`
`CardStrokeDefault`	預設卡片邊框	`#0F000000`	`#1A000000`	`00000010`
`CardStrokeDefaultSolid`	實心卡片邊框，用於半透明筆劃造成可見性問題	`#FFEBEBEB`	`#FF1C1C1C`	`00000010`
`CardStrokeDefaultSolidAlt`	另一種實心卡片邊框	`#FFDADADA`	`#FF0A0A0A`	`00000010`

管理

標記用於標準互動控制，如按鈕、文字框和連擊框。

語彙基元	Description	淺色	深色	高對比
`ControlAltFillDisabled`	停用替代控制背景	`#00FFFFFF`	`#00FFFFFF`	`0000000F`
`ControlAltFillQuaternary`	第四層替代控制背景	`#18000000`	`#12FFFFFF`	`0000000E`
`ControlAltFillSecondary`	第二層替代控制背景	`#06000000`	`#1A000000`	`0000000E`
`ControlAltFillTertiary`	第三層替代控制背景	`#0F000000`	`#0BFFFFFF`	`0000000E`
`ControlAltFillTransparent`	透明替代控制背景	`#00FFFFFF`	`#00FFFFFF`	`0000000E`
`ControlFillActiveInput`	在主動文字輸入時控制背景	`#FFFFFFFF`	`#B21E1E1E`	`0000000F`
`ControlFillDefault`	預設控制背景（靜止狀態）	`#B2FFFFFF`	`#0FFFFFFF`	`0000000F`
`ControlFillDisabled`	失效控制背景	`#4DF9F9F9`	`#0BFFFFFF`	`0000000F`
`ControlFillQuaternary`	第四級控制背景	`#C2F3F3F3`	`#0FFFFFFF`	`0000000E`
`ControlFillSecondary`	二級控制背景（懸停）	`#80F9F9F9`	`#15FFFFFF`	`0000000E`
`ControlFillTertiary`	第三層控制背景（按鍵）	`#4DF9F9F9`	`#08FFFFFF`	`0000000E`
`ControlFillTransparent`	透明控制背景	`#00FFFFFF`	`#00FFFFFF`	`0000000F`
`ControlOnImageFillDefault`	放置於影像上的預設控制背景	`#C9FFFFFF`	`#B21C1C1C`	`0000000F`
`ControlOnImageFillDisabled`	放置於影像時關閉控制背景	`#00FFFFFF`	`#001E1E1E`	`0000000F`
`ControlOnImageFillSecondary`	將滑鼠移至影像時控制背景	`#FFF3F3F3`	`#FF1A1A1A`	`0000000E`
`ControlOnImageFillTertiary`	放置於影像上的按鍵背景	`#FFEBEBEB`	`#FF131313`	`0000000E`
`ControlSolidFillDefault`	實心控制背景，當透明度導致可見性問題時使用	`#FFFFFFFF`	`#FF454545`	`0000000F`
`ControlStrokeDefault`	預設控制邊界（靜止狀態）	`#0F000000`	`#12FFFFFF`	`00000010`
`ControlStrokeForStrongFillWhenOnImage`	控制邊界以加強填充於影像上	`#59FFFFFF`	`#6B000000`	`0000000A`
`ControlStrokeOnAccentDefault`	強調背景控制的預設邊框	`#14FFFFFF`	`#14FFFFFF`	`0000000B`
`ControlStrokeOnAccentDisabled`	關閉重音背景控制邊框	`#0F000000`	`#33000000`	`0000000B`
`ControlStrokeOnAccentSecondary`	懸停邊框用於控制重音背景	`#66000000`	`#24000000`	`0000000B`
`ControlStrokeOnAccentTertiary`	按下邊框以控制點綴背景	`#37000000`	`#37000000`	`0000000B`
`ControlStrokeSecondary`	二級管制邊界	`#0F000000`	`#12FFFFFF`	`00000008`
`ControlStrokeTransparent`	透明控制邊界	`#00FFFFFF`	`#00FFFFFF`	`0000000F`
`ControlStrongFillDefault`	高對比元素如滾動條的強烈控制填充	`#72000000`	`#8BFFFFFF`	`0000000A`
`ControlStrongFillDisabled`	失效強控制填充	`#51000000`	`#3FFFFFFF`	`0000000F`
`ControlStrongStrokeDefault`	勾選框與單選按鈕的強控制邊框	`#9C000000`	`#9AFFFFFF`	`00000008`
`ControlStrongStrokeDisabled`	殘障者強控邊界	`#37000000`	`#28FFFFFF`	`0000000B`

Divider

語彙基元	Description	淺色	深色	高對比
`DividerStrokeDefault`	預設分隔器與分隔器行程	`#14000000`	`#15FFFFFF`	`00000011`

焦點

語彙基元	Description	淺色	深色	高對比
`FocusStrokeInner`	內焦指示行程	`#FFFFFFFF`	`#B2000000`	`00000005`
`FocusStrokeOuter`	外焦點指示行程	`#E4000000`	`#FFFFFFFF`	`00000008`

超連結

語彙基元	Description	淺色	深色	高對比
`HyperlinkFillDisabled`	超連結文字顏色被停用	`#5C000000`	`#5DFFFFFF`	`00000013`
`HyperlinkFillPrimary`	主要超連結文字顏色（休止）	`#FF003E92`	`#FF99EBFF`	`0000001A`
`HyperlinkFillSecondary`	超連結文字顏色（滑鼠漂移）	`#FF001A68`	`#FF60CDFF`	`0000001A`
`HyperlinkFillTertiary`	超連結文字顏色（按鍵）	`#FF005FB8`	`#E560CDFF`	`0000001A`

層與表面

背景、分層表面和頁面層級容器的代幣。

語彙基元	Description	淺色	深色	高對比
`LayerFillAlt`	表面的替代層填充	`#FFFFFFFF`	`#0EFFFFFF`	`00000005`
`LayerFillDefault`	表面和捲軸的預設圖層填充	`#80FFFFFF`	`#4D3A3A3A`	`00000005`
`SolidBackgroundFillBase`	頁面表面的實心底底	`#FFF3F3F3`	`#FF202020`	`00000005`
`SolidBackgroundFillBaseAlt`	替代底座實心背景	`#FFDADADA`	`#FF0A0A0A`	`00000005`
`SolidBackgroundFillSecondary`	次要實心背景（比基礎高一級）	`#FFEEEEEE`	`#FF1C1C1C`	`00000005`
`SolidBackgroundFillTertiary`	第三紀實質背景	`#FFF9F9F9`	`#FF282828`	`00000005`
`SolidBackgroundFillQuaternary`	第四層實體背景	`#FFFFFFFF`	`#FF2C2C2C`	`00000005`
`SolidBackgroundFillQuinary`	第五級實心背景	`#FFFDFDFD`	`#FF333333`	`00000005`
`SolidBackgroundFillSenary`	第六層固體背景	`#FFFFFFFF`	`#FF373737`	`00000005`
`SurfaceBackgroundFillDefault`	底層以上離散曲面的預設背景	`#FFF9F9F9`	`#FF2C2C2C`	`00000005`
`SurfaceStrokeDefault`	預設表面邊界	`#66757575`	`#66757575`	`0000000A`
`SurfaceStrokeFlyout`	飛出地面邊界	`#0F000000`	`#33000000`	`0000000A`

陰影與煙霧

語彙基元	Description	淺色	深色	高對比
`ShadowFlyout`	為跳出表面（如彈出視窗、工具提示和上下文選單）提供陰影顏色	`#24000000`	`#42000000`	`00000005`
`SmokeFillDefault`	煙霧覆蓋色彩用於調暗背景表面	`#4D000000`	`#4D000000`	`0000000F`
`SmokeFillInverse`	反向煙霧覆蓋色	`#C9FFFFFF`	`#B21C1C1C`	`0000000F`

微妙

標記用於視覺權重最小的控制，例如工具列按鈕和選單項目。

語彙基元	Description	淺色	深色	高對比
`SubtleFillDisabled`	禁用微妙控制填充	`#00000000`	`#00FFFFFF`	`00000005`
`SubtleFillSecondary`	微妙的控制填充（懸停）	`#0F000000`	`#0FFFFFFF`	`0000000F`
`SubtleFillTertiary`	微妙的控制填充（按壓）	`#0A000000`	`#0BFFFFFF`	`0000000F`
`SubtleFillTransparent`	透明的微妙控制填充	`#00FFFFFF`	`#00FFFFFF`	`00000005`

系統狀態

狀態指標代幣——注意、謹慎、關鍵、成功和中立。

語彙基元	Description	淺色	深色	高對比
`SystemFillAttention`	注意指示器邊框與筆劃（資訊性）	`#FF005FB7`	`#FF60CDFF`	`00000002`
`SystemFillAttentionBackground`	注意力指示器背景	`#80F6F6F6`	`#08FFFFFF`	`00000018`
`SystemFillCaution`	警告指示器邊框與劃線	`#FF9D5D00`	`#FFFCE100`	`00000002`
`SystemFillCautionBackground`	警示指示器背景	`#FFFFF4CE`	`#FF433519`	`00000018`
`SystemFillCritical`	誤差指示器邊框與筆劃	`#FFC42B1C`	`#FFFF99A4`	`00000002`
`SystemFillCriticalBackground`	錯誤指示器背景	`#FFFDE7E9`	`#FF442726`	`00000018`
`SystemFillNeutral`	中性系統填充	`#72000000`	`#8BFFFFFF`	`00000002`
`SystemFillNeutralBackground`	中立系統背景	`#06000000`	`#08FFFFFF`	`00000018`
`SystemFillSolidAttentionBackground`	實體注意力背景，當透明度造成可見性問題時使用	`#FFF7F7F7`	`#FF2E2E2E`	`00000018`
`SystemFillSolidNeutral`	實心中性指示器填充	`#FF8A8A8A`	`#FF8A8A8A`	`00000002`
`SystemFillSolidNeutralBackground`	實心中性背景	`#FFF3F3F3`	`#FF2E2E2E`	`00000018`
`SystemFillSuccess`	成功指示器邊框與劃線	`#FF0F7B0F`	`#FF6CCB5F`	`00000002`
`SystemFillSuccessBackground`	成功指標背景	`#FFDFF6DD`	`#FF393D1B`	`00000018`

文字

語彙基元	Description	淺色	深色	高對比
`TextFillDisabled`	禁用文字顏色	`#5C000000`	`#5DFFFFFF`	`00000011`
`TextFillPrimary`	一般內容的主文字顏色	`#E4000000`	`#FFFFFFFF`	`00000008`
`TextFillSecondary`	補充內容與提示的次要文字顏色	`#9E000000`	`#C8FFFFFF`	`00000008`
`TextFillTertiary`	三級文字顏色（低對比度——靜止時不用作主要內容）	`#72000000`	`#8BFFFFFF`	`00000008`
`TextOnAccentFillDisabled`	重音背景上的文字被禁用	`#B2FFFFFF`	`#80000000`	`00000003`
`TextOnAccentFillPrimary`	強調背景的主要文本	`#FFFFFFFF`	`#FF000000`	`0000000E`
`TextOnAccentFillSecondary`	關於重音背景的次要文字	`#B2FFFFFF`	`#80000000`	`0000000E`
`TextOnAccentFillSelectedText`	強調背景上選取文字的文字顏色	`#FFFFFFFF`	`#FFFFFFFF`	`0000000E`

貝殼內部顏色

這些標記控制 IDE 的 Chrome 表面——主要視窗框架、工具視窗標頭、分頁、狀態列及其他 shell 層級元素。它們是主題作者用來改變整個 IDE 感覺的主要代幣。

Visual Studio 隨著 shell 區域變得更細緻，會加入 Fluent 色彩標記。 Chrome 表面還能出現額外的標記，如分頁頭和視窗標頭，讓主題作者能獨立於其他 shell Chrome 之外樣式化這些區域。

環境

控制主窗戶和外殼鍍鉻表面的代幣。

語彙基元	Description	淺色	深色	高對比
`EnvironmentBackground`	主視窗背景與浮動工具視窗	`#FFEEEEEE`	`#FF1C1C1C`	`00000005`
`EnvironmentBadge`	解決方案資訊徽章背景（例如，即時分享指示器）	`#B2FFFFFF`	`#0FFFFFFF`	`0000000F`
`EnvironmentBody`	主殼視窗的主體/內容區域背景	`#FFEEEEEE`	`#FF1C1C1C`	`00000005`
`EnvironmentBodyText`	主殼視窗的正文/內容區的文字顏色	`#E4000000`	`#FFFFFFFF`	`00000008`
`EnvironmentBorder`	主動主窗邊框	`#FF5649B0`	`#FF9184EE`	`0000000A`
`EnvironmentBorderInactive`	非啟用的主窗邊框與內部隔板	`#FFADADAD`	`#FF454545`	`00000003`
`EnvironmentHeader`	主動視窗或工具視窗標頭背景，與分頁背景分開	`#FFF9F9F9`	`#FF282828`	`00000005`
`EnvironmentHeaderInactive`	非啟用視窗或工具視窗標頭背景，與分頁背景分開	`#FFF9F9F9`	`#FF282828`	`00000005`
`EnvironmentIndicator`	自動隱藏分頁的邊框或指示器	`#66757575`	`#66757575`	`0000000A`
`EnvironmentLayeredBackground`	像 InfoBar 和分頁群組這類分層元素的背景	`#80FFFFFF`	`#4D3A3A3A`	`00000005`
`EnvironmentLayeredBorder`	邊框是多層元素如資訊條和徽章	`#0F000000`	`#80000000`	`00000010`
`EnvironmentLogo`	Visual Studio 標誌在系統選單中填滿	`#FF5649B0`	`#FF9184EE`	`0000000D`
`EnvironmentTab`	主動分頁標頭背景，與視窗及工具視窗標頭分開	`#FFF9F9F9`	`#FF282828`	`00000005`
`EnvironmentTabInactive`	非活動分頁標頭背景，與視窗及工具視窗標頭分開	`#FFF9F9F9`	`#FF282828`	`00000005`

標題

特別是視窗關閉按鈕的代幣。

語彙基元	Description	淺色	深色	高對比
`CaptionControlCloseFillPrimary`	關閉按鈕背景（滑鼠移轉）	`#FFC42B1C`	`#FFC42B1C`	`0000000D`
`CaptionControlCloseFillSecondary`	關閉按鈕背景（按下）	`#E6C42B1C`	`#E6C42B1C`	`0000000D`
`CaptionControlCloseTextFillPrimary`	關閉按鈕圖示顏色（滑鼠懸停）	`#FFFFFFFF`	`#FFFFFFFF`	`00000009`
`CaptionControlCloseTextFillSecondary`	關閉按鈕圖示顏色（按下）	`#B3FFFFFF`	`#B3FFFFFF`	`00000009`

狀態列

各種模式中狀態欄的代幣。

語彙基元	Description	淺色	深色	高對比
`StatusBarBackgroundFillBuilding`	建構狀態列背景	`#FF5649B0`	`#FF3F3682`	`00000005`
`StatusBarBackgroundFillDebugging`	除錯時的狀態列背景	`#FFBC4B09`	`#FF7A2101`	`00000005`
`StatusBarBackgroundFillRest`	預設狀態下的狀態列背景	`#8B000000`	`#4D000000`	`00000005`
`StatusBarBackgroundFillSolutionLoading`	載入解答時的狀態列背景	`#FF005BA1`	`#FF003B6A`	`00000005`
`StatusBarControlFillSecondary`	狀態列上的次要控制填充	`#33000000`	`#20FFFFFF`	`0000000E`
`StatusBarTextFillBuilding`	建構時的狀態列文字	`#FFFFFFFF`	`#FFFFFFFF`	`00000008`
`StatusBarTextFillDebugging`	除錯時的狀態列文字	`#FFFFFFFF`	`#FFFFFFFF`	`00000008`
`StatusBarTextFillDisabled`	失效狀態列文字	`#90FFFFFF`	`#5DFFFFFF`	`00000011`
`StatusBarTextFillRest`	狀態列文字預設狀態	`#FFFFFFFF`	`#FFFFFFFF`	`00000008`
`StatusBarTextFillSolutionLoading`	載入解答時的狀態列文字	`#FFFFFFFF`	`#FFFFFFFF`	`00000008`

高對比系統色彩參考

高對比度值是系統的色彩指數。 Visual Studio 會將這些色彩映射到使用者的主動高對比色彩方案。常見指數：

Index	系統顏色
`00000001`	`ActiveCaption`
`00000002`	`ActiveCaptionText`
`00000003`	`ActiveBorder`
`00000005`	`Window`
`00000008`	`WindowText`
`00000009`	`HotTrackColor`
`0000000A`	`InactiveBorder`
`0000000B`	`InactiveCaption`
`0000000D`	`Highlight`
`0000000E`	`HighlightText`
`0000000F`	`ButtonFace`
`00000010`	`ButtonShadow`
`00000011`	`GrayText`
`00000013`	`InactiveCaptionText`
`00000018`	`GradientActiveCaption`
`0000001A`	`HotLight`

上次更新時間： 2026-08-24