编辑

辅助功能

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) 并搜索“color blind”以填充相关选项。

Visual Studio Marketplace in VS Code UI

从市场安装颜色主题后，您可以使用文件 > 首选项 > 主题 > 颜色主题 ⌘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+。但是，您可以在用户界面中自定义主题和属性颜色。

注意：有关覆盖当前主题颜色的更多信息，请参阅自定义颜色主题。

要自定义错误和警告波浪线，请转到用户设置中的文件 > 首选项 > 设置。搜索“color customizations”以找到 工作台：颜色自定义 设置，然后选择 在 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（蓝色）对于患有常见色觉缺陷的人来说更容易识别。

选择易于识别的颜色

颜色的可访问性取决于异常三色视觉（色盲）的类型。严重程度因人而异，可分为四种病症类型：

病症	类型
绿色盲	对绿光敏感度降低。它是最常见的色盲类型。
红色盲	对红光敏感度降低。
蓝色盲	对蓝光敏感度降低。这种情况被认为是罕见的。
全色盲	无法看到所有颜色，也称为全色视。有关最罕见的色盲形式的更多信息：盲人斗争基金会。

选择最适合特定病症的颜色的一种最佳方法是应用互补色。这些颜色位于色轮上彼此相对的位置。

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

注意：有关查找互补色的更多信息，请访问 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 以反向顺序 Tab 切换。当您通过 Tab 键切换 UI 控件时，当每个 UI 元素获得焦点时，其周围将出现一个指示器。

工作台中的所有元素都支持 Tab 导航。为了避免过多的 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 moves focus 指示器。

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)) 将显示辅助功能差异查看器，其中差异以统一补丁格式呈现。使用上和下导航未更改、插入或删除的行。按下 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 键以将其“锁定”在适当位置，以便在悬停时不会隐藏。释放键以解锁悬停。

当前已知问题

VS 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 编辑器。
代码导航 - 快速浏览您的源代码。

05/08/2025