協助工具

Visual Studio Code 具備許多功能，可協助所有使用者輕鬆存取編輯器。縮放層級和高對比顏色可改善編輯器可視性，僅限鍵盤導覽支援無需滑鼠即可使用，且編輯器已針對螢幕助讀程式進行最佳化。

縮放

您可以使用檢視 > 外觀 > 縮放指令在 VS Code 中調整縮放層級。每個縮放指令會將縮放層級增加或減少 20%。

檢視 > 外觀 > 放大 (⌘= (Windows、Linux Ctrl+=)) - 增加縮放層級。
檢視 > 外觀 > 縮小 (⌘- (Windows、Linux Ctrl+-)) - 減少縮放層級。
檢視 > 外觀 > 重設縮放 (⌘Numpad0 (Windows、Linux Ctrl+Numpad0)) - 將縮放層級重設為 0。

注意：如果您正在使用放大鏡，請在檢視懸浮資訊時按住 Alt 鍵，以將游標移到懸浮資訊上。

Zoomed in editor

持續的縮放層級

當您使用檢視 > 外觀 > 放大/縮小 指令調整縮放層級時，縮放層級會保存在 window.zoomLevel Open in VS Code Open in VS Code Insiders 設定中。預設值為 0，每次增加/減少會使縮放層級改變 20%。

協助工具說明

指令 開啟協助工具說明 ⌥F1 (Windows Alt+F1、Linux Shift+Alt+F1) 會根據目前內容開啟說明選單。它目前適用於編輯器、終端機、筆記本、聊天檢視和內嵌聊天功能。

您可以從說明選單中關閉協助工具說明選單或開啟其他文件。

When triggered in an editor, a dialog appears that explains how to enable screen reader mode explicitly, tab focus mode and other details

高對比佈景主題

VS Code 支援在所有平台上使用高對比色彩佈景主題。使用檔案 > 喜好設定 > 佈景主題 > 色彩佈景主題 (⌘K ⌘T (Windows、Linux Ctrl+K Ctrl+T)) 來顯示選取色彩佈景主題下拉式選單並選取高對比佈景主題。

High Contrast Theme

色覺協助工具

您可以在 Visual Studio Marketplace 中搜尋與色覺辨識障礙相容的擴充功能。使用擴充功能檢視 ⇧⌘X (Windows、Linux Ctrl+Shift+X) 並搜尋「色盲」以顯示相關選項。

Visual Studio Marketplace in VS Code UI

從 Marketplace 安裝色彩佈景主題後，您可以使用檔案 > 喜好設定 > 佈景主題 > 色彩佈景主題 ⌘K ⌘T (Windows、Linux Ctrl+K Ctrl+T) 變更色彩佈景主題。

Dropdown for Select Color Theme

建議的色覺協助工具佈景主題

GitHub - 對大多數形式的色盲使用者皆可存取，並符合 GitHub 設定中的佈景主題。
Gotthard - 針對約 20 種程式語言進行最佳化。
Blinds - 為患有綠色盲的人士建立，具有高對比色彩比例。
Greative - 考量色盲和光敏感度。
Pitaya Smoothie - 對大多數形式的色盲使用者皆可存取，並符合 WCAG 2.1 色彩對比標準。

自訂警告顏色

VS Code 的預設色彩佈景主題是 Dark+。但是，您可以自訂使用者介面中的佈景主題和屬性顏色。

注意：請前往自訂色彩佈景主題以取得更多關於覆寫目前佈景主題中顏色的資訊。

若要自訂錯誤和警告的波浪底線，請前往檔案 > 喜好設定 > 設定以設定使用者設定。搜尋「顏色自訂」以找到 工作台：顏色自訂 設定，然後透過選取在 settings.json 中編輯來開啟您的使用者 settings.json 檔案。

JSON file settings icon

在您的 settings.json 檔案中，將以下程式碼巢狀放置在最外層的大括號內。您可以透過輸入十六進位碼為每個物件指定顏色。

"workbench.colorCustomizations": {
    "editorError.foreground": "#ffef0f",
    "editorWarning.foreground": "#3777ff"
}

在以下範例中，當 JSON 項目後面缺少逗號時，會套用警告顏色。

JSON code to alter error/warning squiggle colors

editorError.foreground - 覆寫錯誤下方的波浪線。
editorWarning.foreground - 覆寫警告下方的波浪線。
editorError.background - 覆寫錯誤的醒目提示顏色。
editorWarning.background - 覆寫警告的醒目提示顏色。

為 editorError 和 editorWarning 的背景指定顏色也有助於識別潛在問題。您選擇的顏色將會醒目提示相應的錯誤或警告。前述範例中顯示的顏色，#ffef0f (黃色) 和 #37777ff (藍色)，對於患有常見形式色覺辨識障礙的人士更具協助工具。

選取具協助工具的顏色

顏色的協助工具程度取決於異常三色視覺 (色盲) 的類型。嚴重程度因人而異，並可分為四種狀況類型

狀況	類型
綠色盲	對綠光敏感度降低。這是最常見的色盲形式。
紅色盲	對紅光敏感度降低。
藍色盲	對藍光敏感度降低。這種情況被認為很罕見。
全色盲	無法看見所有顏色，也稱為全色盲 (achromatopsia)。關於最罕見色盲形式的更多資訊：抗盲基金會。

針對特定狀況選擇最佳顏色的最佳方法之一是應用互補色。這些是在色輪上彼此相對的顏色。

Color wheel highlighting complementary colors for regular vision, deuteranopia, protanopia, tritanopia and monochromacy

注意：如需更多關於尋找互補色的資訊，請造訪 Adobe Color 上的色盲模擬器和互動式色輪。

調暗非焦點編輯器和終端機

未聚焦的檢視可以變暗，以更清楚地顯示鍵入的輸入將會移至何處。這在處理多個編輯器群組或終端機時特別有用。透過設定 "accessibility.dimUnfocused.enabled": true 來開啟此功能。您可以使用 accessibility.dimUnfocused.opacity Open in VS Code Open in VS Code Insiders 控制調暗程度，其不透明度分數範圍為 0.2 到 1 (預設為 0.75)。

VS Code 在命令選擇區 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 中提供了詳盡的指令清單，以便您無需滑鼠即可使用 VS Code。按下 ⇧⌘P (Windows、Linux Ctrl+Shift+P)，然後輸入指令名稱 (例如「git」) 以篩選指令清單。

VS Code 還為指令設定了許多預設的鍵盤快捷鍵。

Key bindings for commands are displayed at the end of the command palette entry

您也可以設定自己的鍵盤快捷鍵。檔案 > 喜好設定 > 鍵盤快捷鍵 (⌘K ⌘S (Windows、Linux Ctrl+K Ctrl+S)) 會開啟鍵盤快捷鍵編輯器，您可以在其中探索和修改 VS Code 動作的鍵盤快捷鍵。請參閱按鍵綁定以取得更多關於自訂或新增您自己的鍵盤快捷鍵的詳細資訊。

為了在工作台快速導覽，我們建議使用聚焦下一個部分 (F6) 和聚焦上一個部分 (⇧F6 (Windows、Linux Shift+F6)) 指令。

錨點選取

為了更方便使用鍵盤開始和結束選取範圍，有四個指令：設定選取錨點 (⌘K ⌘B (Windows、Linux Ctrl+K Ctrl+B))、從錨點選取到游標 (⌘K ⌘K (Windows、Linux Ctrl+K Ctrl+K))、取消選取錨點 (Escape) 和移至選取錨點。

您可以使用 Tab 鍵在 VS Code 的 UI 控制項之間導覽。使用 Shift+Tab 鍵以相反順序導覽。當您透過 Tab 鍵在 UI 控制項之間移動時，當每個 UI 元素獲得焦點時，其周圍會出現一個指示器。

工作台中的所有元素都支援 Tab 鍵導覽。為避免過多的 Tab 鍵停駐點，工作台工具列和 Tab 鍵清單各只有一個。一旦工具列或 Tab 鍵清單獲得焦點，您可以使用方向鍵在其中導覽。

注意：Tab 鍵導覽按照視覺自然順序進行，除了 WebViews (例如 Markdown 預覽)。對於 WebViews，我們建議使用 F6 和 ⇧F6 (Windows、Linux Shift+F6) 指令在 WebViews 和工作台的其餘部分之間導覽。或者，您可以使用多個「聚焦編輯器」指令之一。

Tab 鍵陷阱

預設情況下，在原始碼檔案中按下 Tab 鍵會插入 Tab 字元 (或空格，取決於您的縮排設定)，並且不會離開開啟的檔案。您可以使用 ⌃⇧M (Windows、Linux Ctrl+M) 開啟/關閉 Tab 鍵陷阱，之後的 Tab 鍵將會使焦點移出檔案。當預設 Tab 鍵陷阱關閉時，您會在狀態列中看到「Tab 鍵移動焦點」指示器。

Tab 鍵陷阱也存在於整合式終端機中。此功能的預設行為可以使用 editor.tabFocusMode Open in VS Code Open in VS Code Insiders 進行設定。

A Tab moves focus status bar item shows when the mode is active

您也可以從命令選擇區 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 透過「切換 Tab 鍵移動焦點」動作來開啟和關閉 Tab 鍵陷阱。

唯讀檔案永遠不會捕捉 Tab 鍵。整合式終端機面板遵循 Tab 鍵陷阱模式，並可使用 ⌃⇧M (Windows、Linux Ctrl+M) 切換。

螢幕助讀程式

VS Code 在編輯器中支援螢幕助讀程式，採用基於文字分頁的策略。已測試以下螢幕助讀程式

Windows：NVDA 和 JAWS
macOS：VoiceOver
Linux：Orca

對於 NVDA，我們建議您停留在焦點模式並使用熱鍵導覽，而不是使用瀏覽模式。

移至下一個/上一個錯誤或警告動作 (F8 和 ⇧F8 (Windows、Linux Shift+F8)) 允許螢幕助讀程式朗讀錯誤和警告訊息。

當建議彈出時，螢幕助讀程式會朗讀它們。使用 Ctrl+Up 和 Ctrl+Down 導覽建議，並使用 Shift+Escape 關閉它們。如果建議妨礙了您，您可以透過 editor.quickSuggestions Open in VS Code Open in VS Code Insiders 設定將其關閉。

在差異檢視窗格中，移至下一個/上一個差異動作 (F7 和 ⇧F7 (Windows、Linux Shift+F7)) 將顯示協助工具差異檢視器，其中差異以統一的修補程式格式呈現。使用 Up 和 Down 導覽未更改、插入或刪除的行。按下 Enter 鍵將焦點返回到差異編輯器的已修改窗格中的選定行號 (如果選取了已刪除的行，則為最接近且仍然存在的行號)。使用 Escape 或 Shift+Escape 關閉協助工具差異檢視器。

螢幕助讀程式模式

當 VS Code 偵測到正在使用螢幕助讀程式時，它會進入針對編輯器和整合式終端機等 UI 最佳化的螢幕助讀程式模式。狀態列右下方將顯示「螢幕助讀程式最佳化」。您可以透過點擊顯示文字或使用「切換螢幕助讀程式協助工具模式」指令來退出螢幕助讀程式模式。

Activating the screen reader optimized status bar will show a notification that allows disabling the mode

在螢幕助讀程式模式下，某些功能 (例如摺疊和迷你地圖 (程式碼概觀)) 會被停用。您可以使用編輯器：協助工具支援設定 ( editor.accessibilitySupport Open in VS Code Open in VS Code Insiders ) 控制 VS Code 是否使用螢幕助讀程式模式，其值為 on、off 或預設的 auto，後者會透過查詢平台自動偵測螢幕助讀程式。

透過鍵盤調整表格欄位大小

list.resizeColumn 指令可讓您使用鍵盤調整欄位大小。您可以指派鍵盤快捷鍵來觸發此指令。

當您觸發此指令時，選取要調整大小的欄位，並提供您要設定的寬度百分比。以下影片顯示如何將此功能應用於在鍵盤快捷鍵編輯器中調整欄位大小。

協助工具檢視

執行指令開啟協助工具檢視 ⌥F2 (Windows Alt+F2、Linux Shift+Alt+F2) 以顯示協助工具檢視，並逐字、逐行檢查內容。協助工具檢視目前可用於懸浮資訊、通知、註解、筆記本輸出、終端機輸出、聊天回應、內嵌完成、偵錯主控台輸出等。

在擴充功能檢視、鍵盤快捷鍵編輯器以及註解、問題和偵錯主控台面板中，使用 (⌘↓ (Windows、Linux Ctrl+Down)) 和 (⌘↑ (Windows、Linux Ctrl+Up)) 在輸入控制項 (例如，搜尋或篩選輸入) 及其結果之間導覽是一致的。

終端機協助工具

您可以透過 ⌥F1 (Windows Alt+F1、Linux Shift+Alt+F1) 顯示終端機協助工具說明，其中描述了使用螢幕助讀程式時的實用提示。其中一個提示是使用 ⌥F2 (Windows Alt+F2、Linux Shift+Alt+F2) 存取終端機中的緩衝區。這將根據您的螢幕助讀程式，自動進入螢幕助讀程式的瀏覽模式，以提供整個終端機緩衝區的協助工具檢視。

使用 editor.tabFocusMode Open in VS Code Open in VS Code Insiders 控制終端機是否接收 Tab 鍵而不是工作台，類似於編輯器。

Shell 整合

終端機具有稱為shell 整合的功能，可啟用許多其他終端機中沒有的額外功能。使用螢幕助讀程式時，「執行最近的指令」和「移至最近的目錄」功能特別有用。

另一個由 Shell 整合提供的指令「在協助工具檢視中移至符號」(⇧⌘O (Windows、Linux Ctrl+Shift+O))，可讓您在終端機指令之間導覽，類似於編輯器中的「在編輯器中移至符號...」導覽。

最小對比度

將 terminal.integrated.minimumContrastRatio Open in VS Code Open in VS Code Insiders 設定為 1 到 21 之間的數字，以調整文字顏色亮度，直到達到所需的對比度或達到純白色 (`#FFFFFF`) 黑色 (`#000000`) 為止。

請注意， terminal.integrated.minimumContrastRatio Open in VS Code Open in VS Code Insiders 設定不適用於 powerline 字元。

狀態列協助工具

一旦透過聚焦下一個部分 (F6) 將焦點置於狀態列，您可以使用方向鍵導覽在狀態列項目之間移動焦點。

差異編輯器協助工具

差異編輯器中有一個協助工具差異檢視器，以統一的修補程式格式呈現變更。您可以使用「移至下一個差異」(F7) 和「移至上一個差異」(⇧F7 (Windows、Linux Shift+F7)) 在變更之間導覽。使用方向鍵導覽行，然後按下 Enter 鍵跳回到差異編輯器中的選定行。

偵錯工具協助工具

VS Code 偵錯工具 UI 可供使用者存取，並具有以下功能

朗讀偵錯狀態變更 (例如，「已啟動」、「中斷點命中」、「已終止」等)。
所有偵錯動作均可透過鍵盤存取。
「執行和偵錯」檢視和「偵錯主控台」都支援 Tab 鍵導覽。
偵錯懸浮資訊可透過鍵盤存取 (⌘K ⌘I (Windows、Linux Ctrl+K Ctrl+I))。
可以建立鍵盤快捷鍵以將焦點設定到每個偵錯工具區域。
在偵錯時且焦點位於編輯器中，調用「偵錯：新增至監看」指令會朗讀變數的值。

協助工具訊號

協助工具訊號指示當前行是否具有某些標記，例如：錯誤、警告、中斷點、摺疊的文字區域或內嵌建議。

當主游標變更其行或首次將標記新增到當前行時，會播放它們。當連接螢幕助讀程式時，協助工具訊號音效和公告可能會自動啟用，並可透過 accessibility.signals.* 設定進行控制。

指令「說明：列出訊號音效」會列出所有可用的音效，讓您在清單中移動時聽到每個音效，並允許設定它們的啟用/停用狀態。

Aria 公告也會告知螢幕助讀程式和點字使用者已命中某些標記。指令「說明：列出訊號公告」會告知使用者哪些可用，並允許設定它們的啟用/停用狀態。

懸浮資訊協助工具

某些懸浮資訊無法正常懸停，這使得它們難以與螢幕放大鏡一起使用。為了解決這個問題，當懸浮資訊處於活動狀態時，按住 Alt 或 Option 鍵將其「鎖定」在位置上，這樣在懸停時它就不會隱藏。放開按鍵以解鎖懸浮資訊。

目前已知問題

VS Code 有一些已知協助工具問題，具體取決於平台。如需完整清單，請前往VS Code 協助工具問題。

macOS

編輯器包含對 VoiceOver 的螢幕助讀程式支援。

Linux

VS Code 與 Orca 螢幕助讀程式配合良好。如果您的 Linux 發行版中的 Orca 未讀取編輯器內容

請確保在 VS Code 中將設定 "editor.accessibilitySupport": "on"。您可以使用設定來執行此操作，或者透過執行「顯示協助工具說明」指令並按下 Ctrl+E 來開啟協助工具支援。
如果 Orca 仍然沒有聲音，請嘗試將 ACCESSIBILITY_ENABLED=1 設定為環境變數。

啟用該設定後，VS Code 應該可以與 Orca 螢幕助讀程式配合使用。

後續步驟

繼續閱讀以了解

語音互動 - 了解如何在 VS Code 中使用語音指令。
Visual Studio Code 使用者介面 - 快速了解 VS Code。
基本編輯 - 了解功能強大的 VS Code 編輯器。
程式碼導覽 - 在原始碼中快速移動。

02/04/2026