辅助功能

Visual Studio Code 提供了许多功能，旨在帮助所有用户更方便地使用编辑器。缩放级别和高对比度颜色可提高编辑器的可见性，仅键盘导航支持无需鼠标即可使用，编辑器也针对屏幕阅读器进行了优化。

缩放

您可以使用 **视图** > **外观** > **缩放** 命令在 VS Code 中调整缩放级别。每个 **缩放** 命令会将缩放级别增加或减少 20%。

视图 > 外观 > 放大 (⌘= (Windows, Linux Ctrl+=)) - 提高缩放级别。
视图 > 外观 > 缩小 (⌘- (Windows, Linux Ctrl+-)) - 降低缩放级别。
视图 > 外观 > 重置缩放 (⌘Numpad0 (Windows, Linux Ctrl+Numpad0)) - 将缩放级别重置为 0。

注意：如果您正在使用放大镜，请在查看悬停时按住 Alt 键，将光标移到悬停上。

Zoomed in editor

持久化缩放级别

当您使用 **视图** > **外观** > **放大/缩小** 命令调整缩放级别时，缩放级别会保存在 **window.zoomLevel** 设置中。默认值为 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

自定义警告颜色

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 (蓝色)，对于有常见色觉缺陷的人来说更易于访问。

选择可访问的颜色

颜色的可访问性是主观的，取决于异常三色视（色盲）的类型。严重程度因人而异，可分为四种情况类型

情况	类型
二色性视	对绿光敏感度降低。这是最常见的色盲形式。
一色性视	对红光敏感度降低。
三色性视	对蓝光敏感度降低。这种情况被认为是罕见的。
全色盲	无法看到所有颜色，也称为正色盲。有关最罕见色盲形式的更多信息：Fighting Blindness 基金会。

选择特定情况最佳颜色的最佳方法之一是使用互补色。这些颜色在色轮上位于彼此相对的位置。

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

注意：有关查找互补色的更多信息，请访问 Adobe Color 上的色盲模拟器和交互式色轮：Adobe Color。

调暗未聚焦的编辑器和终端

未聚焦的视图可以调暗，以更清楚地显示输入内容将进入的位置。当使用多个编辑器组或终端时，这尤其有用。通过设置 "accessibility.dimUnfocused.enabled": true 来启用此功能。您可以通过 accessibility.dimUnfocused.opacity 控制调暗级别，该级别接受 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 可反向制表。当您制表浏览 UI 控件时，当 UI 元素获得焦点时，周围会出现一个指示器。

工作区中的所有元素都支持制表导航。为了避免过多的制表位，工作区工具栏和选项卡列表每个只有一个。一旦工具栏或选项卡列表获得焦点，您就可以使用箭头键在其中导航。

注意：制表导航的顺序在视觉上是自然的，除了 WebViews（如 Markdown 预览）。对于 WebViews，我们建议使用 **聚焦下一个部分** (F6) 和 **聚焦上一个部分** (⇧F6 (Windows, Linux Shift+F6)) 命令来在 WebViews 和工作区的其余部分之间导航。或者，您也可以使用许多 **聚焦编辑器** 命令中的一个。

选项卡捕获

默认情况下，在源文件代码中按 Tab 会插入 Tab 字符（或空格，取决于您的缩进设置），并且不会离开打开的文件。您可以使用 ⌃⇧M (Windows, Linux Ctrl+M) 来切换 **Tab 捕获**，随后按 Tab 键将焦点移出文件。当默认的 **Tab 捕获** 关闭时，您将在状态栏中看到 **Tab 移动焦点** 指示器。

集成终端也存在 Tab 捕获。此功能的默认行为可以通过 editor.tabFocusMode 配置。

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 设置将其关闭。

在差异视图窗格中，**转到下一个/上一个差异** 操作 (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) 来控制 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 来控制终端是接收 Tab 键还是工作区，类似于编辑器。

Shell 集成

终端具有名为 Shell 集成的功能，该功能支持许多其他终端中没有的功能。在使用屏幕阅读器时，**运行最近命令** 和 **转到最近目录** 功能特别有用。

另一个由 Shell 集成支持的命令 **在可访问视图中转到符号** (⇧⌘O (Windows, Linux Ctrl+Shift+O)) 允许您在终端命令之间导航，类似于编辑器中的 **在编辑器中转到符号...** 导航。

最小对比度

将 terminal.integrated.minimumContrastRatio 设置为 1 到 21 之间的数字，以调整文本颜色亮度，直到达到所需的对比度比率或达到纯白色 (#FFFFFF) 或黑色 (#000000)。

请注意，terminal.integrated.minimumContrastRatio 设置不适用于 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 键将其“锁定”在原地，这样它就不会在悬停时隐藏。释放该键即可解锁悬停。

当前已知问题

Visual Studio Code 存在一些已知的辅助功能问题，具体取决于平台。有关完整列表，请访问 VS Code 辅助功能问题。

macOS

编辑器包含 VoiceOver 的屏幕阅读器支持。

Linux

VS Code 与 Orca 屏幕阅读器配合良好。如果您的 Linux 发行版中的 Orca 未能读取编辑器内容

确保在 VS Code 中设置了 "editor.accessibilitySupport": "on"。您可以使用设置来实现此目的，或者运行 **显示辅助功能帮助** 命令并按 Ctrl+E 来打开 accessibilitySupport。
如果 Orca 仍然没有声音，请尝试将 ACCESSIBILITY_ENABLED=1 设置为环境变量。

启用该设置后，VS Code 应能与 Orca 屏幕阅读器配合使用。

后续步骤

继续阅读以了解：

语音交互 - 了解如何在 VS Code 中使用语音命令。
Visual Studio Code 用户界面 - VS Code 的快速上手指南。
基本编辑 - 了解功能强大的 VS Code 编辑器。
代码导航 - 快速浏览您的源代码。

01/08/2026