💻 欢迎参加 6 月 3 日 MS Build 上的 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 在 VS Code 中打开 在 VS Code Insiders 中打开 设置中。默认值为 0。每高于或低于 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

推荐的色觉辅助主题

  • GitHub - 对大多数色盲类型友好，并与 GitHub 设置中的主题匹配。
  • Gotthard - 针对约 20 种编程语言进行了优化。
  • Blinds - 为绿色盲（Deuteranopia）用户创建，具有高对比度比率。
  • 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（蓝色）对于患有常见色觉缺陷的人群更友好。

选择可访问的颜色

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

病症 类型
绿色盲 (Deuteranopia) 对绿光敏感度降低。这是最常见的色盲类型。
红色盲 (Protanopia) 对红光敏感度降低。
蓝色盲 (Tritanopia) 对蓝光敏感度降低。此病症较为罕见。
全色盲 (Monochromia) 无法辨别所有颜色，也称为 achromatopsia。更多关于这种最罕见色盲形式的信息：Foundation for Fighting Blindness。

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

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

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

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

未聚焦的视图可以被调暗，以便更清晰地了解输入内容的位置。这在处理多个编辑器组或终端时特别有用。通过设置 "accessibility.dimUnfocused.enabled": true 开启此功能。你可以使用 accessibility.dimUnfocused.opacity 在 VS Code 中打开 在 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 键导航

你可以使用 Tab 键在 VS Code 的 UI 控件之间导航。使用 Shift+Tab 以相反顺序切换。当你通过 UI 控件切换时，每个获得焦点的 UI 元素周围都会出现一个指示器。

工作台中的所有元素都支持 Tab 导航。为避免 Tab 停留点过多，工作台工具栏和选项卡列表各只有一个。一旦工具栏或选项卡列表获得焦点，你就可以使用箭头键在其中进行导航。

注意：除 WebView（如 Markdown 预览）外，Tab 导航按视觉自然顺序进行。对于 WebView，我们建议使用 F6 和 ⇧F6 (Windows, Linux Shift+F6) 命令在 WebView 和其余工作台之间切换。或者，你可以使用多个“聚焦编辑器”命令之一。

Tab 键捕获

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

集成终端中也存在 Tab 键捕获。此功能的默认行为可以通过 editor.tabFocusMode 在 VS Code 中打开 在 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 使用基于文本分页的策略在编辑器中支持屏幕阅读器。已测试的屏幕阅读器包括：

对于 NVDA，我们建议保持在焦点模式并使用快捷键进行导航，而不是使用浏览模式。

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

当建议弹出时，它们会被告知给屏幕阅读器。使用 Ctrl+Up 和 Ctrl+Down 导航建议，并使用 Shift+Escape 关闭它们。如果建议干扰了你的操作，可以通过 editor.quickSuggestions 在 VS Code 中打开 在 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 在 VS Code 中打开 在 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 在 VS Code 中打开 在 VS Code Insiders 中打开 来控制终端是否像编辑器一样接收 Tab 键，而不是让工作台接收。

Shell 集成

终端具有一项称为 shell 集成 的功能，可实现许多其他终端所没有的额外特性。使用屏幕阅读器时，运行最近命令 和 转到最近目录 功能特别有用。

另一个由 shell 集成支持的命令，在辅助视图中转到符号 (⇧⌘O (Windows, Linux Ctrl+Shift+O))，允许你像在编辑器中一样使用“转到符号...”导航在终端命令之间切换。

最小对比度

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

请注意， terminal.integrated.minimumContrastRatio 在 VS Code 中打开 在 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 来开启 accessibilitySupport。
  • 如果 Orca 仍然静音，请尝试设置环境变量 ACCESSIBILITY_ENABLED=1。

启用该设置后，VS Code 应该可以与 Orca 屏幕阅读器协同工作。

后续步骤

继续阅读以了解：

02/04/2026
English 한국어 中文(简体) 中文(繁體)
© . This site is unofficial and not affiliated with Microsoft.