vscode 高对比度功能依赖系统级设置，必须先开启操作系统高对比模式才能激活 high contrast 主题及配套辅助行为；仅修改 settings.json 或安装插件无效。
VSCode 本身没有“高对比度开关”，它只响应操作系统级的高对比度模式；装插件、改 settings.json、手动调 editor.foreground 都不能真正触发高对比逻辑——除非系统先开。
必须先开启系统高对比度模式
VSCode 的 High Contrast Black 或 High Contrast Light 主题只有在系统报告“高对比已启用”时才会激活，并同步启用语义高亮、强化边框、禁用透明度等辅助行为。Windows/macOS/Linux 开启路径不同，但缺一不可：
- Windows：设置 → 辅助功能 → 高对比度 → 开启（并选择一种方案）
- macOS：系统设置 → 辅助功能 → 显示 → 启用“增加对比度”+“减少透明度”（VSCode 不自动切主题，需手动选
High Contrast类） - Linux（GNOME）：设置 → 辅助功能 → 高对比度 → 打开（VSCode 1.85+ 已适配）
没走这步，workbench.colorCustomizations 写满也救不了基础可读性崩塌。验证是否生效：重启 VSCode 后，右下角语言模式旁会出现黄色感叹号图标。
editor.contrastBorder 是唯一可靠的边界增强方式
即使系统没开高对比，你也能靠 editor.contrastBorder 强制加粗关键 UI 边界——这对括号匹配、选中行、活动标签页的识别比调背景色更直接有效：
- 在
settings.json中添加："editor.contrastBorder": "#000000"（必须是纯黑或纯白，灰阶色在高对比场景下易失效） - 配套建议加：
"editor.inactiveSelectionBackground": "#3a3a3a"和"editorWidget.border": "#000000" - 注意：
editor.foreground在系统高对比启用后会被主题覆盖，别在这儿硬调；优先动editor.selectionBackground或editor.lineHighlightBackground
别信插件描述里的“高对比”，拿 WCAG 工具实测
很多插件标题写“High Contrast”，实际只是深色/浅色主题变体，根本达不到 WCAG AA 标准（≥4.5:1）。必须抽检三类关键对比：
-
editor.foregroundvseditor.background -
editor.stringForegroundvseditor.background -
editor.commentForegroundvseditor.background
用 WebAIM Contrast Checker 输入十六进制色值验证。例如 #e0e0e0 配 #121212 对比度约 12.3:1 ✅；但 #888888 配同一背景仅 2.3:1 ❌，不可读。第三方主题如 Noctis Lux 多数已过测，但仍建议抽检。
tokenColorScheme 必须手动对齐，否则代码区割裂
换主题后代码颜色没变？大概率是 editor.tokenColorScheme 没同步切换。VSCode 把 UI 皮肤（workbench.colorTheme）和语法高亮（editor.tokenColorScheme）拆成两套配置：
- 进设置搜
token color scheme，右侧下拉选和当前 UI 主题风格一致的项（如选了High Contrast Black，这里就得选High Contrast） - 或直接在
settings.json加："editor.tokenColorScheme": "High Contrast"（大小写敏感，"high contrast"无效） - 如果之前设过
editor.tokenColorCustomizations，它会覆盖主题的 token 配置，临时删掉再试
终端和 Markdown 预览也得单独配：terminal.integrated.theme 和 markdown.preview.theme，否则 UI 和代码区颜色不一致。
最常被忽略的是：系统高对比模式开启后，VSCode 不会保留你之前自定义的 workbench.colorCustomizations 覆盖项——它会按内置 High Contrast 主题规则重载全部颜色。想微调，得在 High Contrast 主题基础上再做 colorCustomizations，且必须等系统模式生效后再改。
