VSCode无障碍支持需启用屏幕阅读器模式、高对比度主题、键盘导航、自定义ARIA标签及内联提示。依次执行：切换屏幕阅读器支持；启用高对比度主题并调大字体；开启键盘导航；在JSON中添加ARIA描述；启用编辑器快速建议。
如果您在使用 VSCode 时遇到屏幕阅读器无法准确播报界面元素、键盘导航跳过关键控件或高对比度模式下颜色信息丢失等问题，则可能是 VSCode 的无障碍支持配置未被正确启用或调整。以下是针对不同使用场景的多种配置与操作方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用屏幕阅读器支持模式
VSCode 内置了专为屏幕阅读器优化的运行模式，启用后会禁用部分动画效果、增强 ARIA 标签输出，并强制使用语义化 DOM 结构，使 NVDA、VoiceOver 等工具能更可靠地识别编辑器状态。
1、按下 Cmd + Shift + P（Mac）或 Ctrl + Shift + P（Windows/Linux）打开命令面板。
2、输入并选择 Toggle Screen Reader Support。
3、确认状态栏右下角出现 Screen Reader Optimized 提示。
二、配置高对比度主题与字体可读性
高对比度模式通过提升前景与背景的亮度差值，帮助低视力用户区分界面区域；同时增大默认字体尺寸与行高可显著改善文本辨识度，无需依赖缩放功能即可清晰阅读代码和侧边栏内容。
1、打开设置界面：按下 Cmd + ,（Mac）或 Ctrl + ,（Windows/Linux）。
2、在搜索框中输入 high contrast，勾选 Workbench > Appearance: High Contrast Theme。
3、继续搜索 font size，将 Window: Zoom Level 设为 0，再将 Editor: Font Size 调整至 16 或更高。
三、启用键盘导航快捷键集
VSCode 默认支持全键盘操作，但部分焦点管理行为需手动开启以确保 Tab 键、方向键和快捷键组合能按预期遍历所有可交互区域（如活动栏、侧边栏、编辑器组、面板），避免焦点丢失或跳过树状结构节点。
1、进入设置界面，搜索 keyboard navigation。
2、启用 Workbench > Keyboard Navigation: Enabled。
3、在终端中执行命令：code --disable-gpu（仅首次调试时使用，可避免 GPU 渲染导致的焦点捕获异常）。
四、自定义 ARIA 标签与描述性提示
对于自定义扩展或频繁使用的 UI 区域（如 GitLens 的提交历史面板、Prettier 的格式化按钮），可通过用户设置注入额外的 aria-label 或 aria-describedby 属性，使屏幕阅读器播报更精准的操作上下文。
1、打开用户设置 JSON 文件：命令面板中输入 Preferences: Open Settings (JSON)。
2、在 "editor.accessibilitySupport" 下添加键值对："workbench.tree.ariaLabel": "文件资源管理器，当前展开 3 个项目"。
3、保存后重启 VSCode，使用 VoiceOver 按 Ctrl + Option + U 查看当前焦点元素的完整 ARIA 描述。
五、启用编辑器内联无障碍提示
该功能在光标停留于语法错误、警告或建议修复项上时，自动触发语音播报或悬浮文字强化提示，无需切换焦点即可获知问题类型与推荐操作，适用于注意力分散或多重障碍用户。
1、在设置中搜索 accessibility quick suggestion。
2、启用 Editor > Accessibility: Quick Suggestions。
3、将光标悬停于带波浪线的代码行，等待 1.5 秒 后查看右上角浮现的无障碍提示卡片。
