在 VS Code 中试用

辅助功能

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

从 Marketplace 安装颜色主题后,您可以使用 文件 > 首选项 > 主题 > 颜色主题 ⌘K ⌘T (Windows、Linux Ctrl+K Ctrl+T) 更改颜色主题

Dropdown for Select Color Theme

自定义警告颜色

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 - 覆盖警告的突出显示颜色。

editorErroreditorWarning 的背景分配颜色也有助于识别潜在问题。您选择的颜色将突出显示相应的错误或警告。上例中显示的颜色 #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 导航

您可以使用 Tab 键在 VS Code 中的 UI 控件之间导航。使用 Shift+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 进行配置。

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 通过基于文本分页的策略在编辑器中支持屏幕阅读器。以下屏幕阅读器已经过测试:

对于 NVDA,我们建议您保持在焦点模式下并使用热键导航,而不是使用浏览模式。

转到下一个/上一个错误或警告 操作 (F8⇧F8 (Windows、Linux Shift+F8)) 允许屏幕阅读器播报错误和警告消息。

当建议弹出时,它们会被屏幕阅读器播报。使用 Ctrl+UpCtrl+Down 导航建议,并使用 Shift+Escape 撤销它们。如果建议碍事,您可以使用 editor.quickSuggestions 设置将其关闭。

在差异视图窗格中,转到下一个/上一个差异 操作 (F7⇧F7 (Windows、Linux Shift+F7)) 将显示辅助差异查看器,其中差异以统一补丁格式呈现。使用 UpDown 导航未更改、插入或删除的行。按 Enter 将焦点返回到差异编辑器的修改窗格中的选定行号(如果选择的行已删除,则返回到仍然存在的最接近的行号)。使用 EscapeShift+Escape 关闭辅助差异查看器。

屏幕阅读器模式

当 VS Code 检测到正在使用屏幕阅读器时,它会进入针对编辑器和集成终端等 UI 优化的屏幕阅读器模式。状态栏右下角将显示 屏幕阅读器优化。您可以通过单击显示文本或使用 切换屏幕阅读器辅助功能模式 命令退出屏幕阅读器模式。

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

在屏幕阅读器模式下,某些功能(如折叠和迷你地图(代码概览))会被禁用。您可以使用 编辑器:辅助功能支持 设置 (editor.accessibilitySupport) 和 onoff 或默认的 auto 值(通过查询平台自动检测屏幕阅读器)来控制 VS Code 是否使用屏幕阅读器模式。

通过键盘调整表格列大小

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 播报还会通知屏幕阅读器和盲文用户某些标记已被命中。命令 帮助:列出信号播报 通知用户哪些可用,并允许配置其启用/禁用状态。

悬停辅助功能

某些悬停无法正常悬停,这使得它们难以与屏幕放大镜一起使用。为了解决这个问题,在悬停激活时按住 AltOption 键以将其“锁定”到位,这样它在悬停时就不会隐藏。松开按键即可解锁悬停。

当前已知问题

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 屏幕阅读器配合使用。

下一步

继续阅读以了解: