vscode高对比度需系统级开启而非仅装插件：windows/macos/linux须先启用系统高对比模式，vscode才自动切换high contrast主题；否则插件仅作普通主题，对比度未必达标。
VSCode 插件本身不提供“高对比度颜色主题开关”——它只响应系统级高对比模式，或依赖主题插件自身是否符合 WCAG 对比标准。直接装个插件就变高对比，大概率无效。
为什么装了高对比主题插件却没效果？
常见错误是把“高对比主题”和“启用高对比”混为一谈。VSCode 的 High Contrast 主题（如 High Contrast Black）只有在操作系统真正开启高对比模式后才会被自动激活，并同步启用语义高亮、强化边框等辅助行为。单纯在插件市场搜“high contrast”装个主题，若系统没开高对比，它只是个普通深色/浅色主题，对比度未必达标。
- Windows：设置 → 辅助功能 → 高对比度 → 开启（会自动触发 VSCode 切换到
High Contrast Black或High Contrast Light） - macOS：系统设置 → 辅助功能 → 显示 → 启用“增加对比度” + “减少透明度”（VSCode 会响应，但不强制切换主题，需手动选
High Contrast类主题） - Linux（GNOME）：设置 → 辅助功能 → 高对比度 → 打开（部分 DE 支持，VSCode 1.85+ 已适配）
没走这一步，settings.json 里写再多 workbench.colorCustomizations，也救不了基础对比崩塌。
如何验证你用的主题真有高对比？
别信插件描述里的“高对比”“护眼”“清晰”——得测。核心是三类文本与背景的对比度必须 ≥ 4.5:1（WCAG AA 标准）：
-
editor.foreground（普通代码文字）vseditor.background -
editor.stringForeground（字符串）vseditor.background -
editor.commentForeground（注释）vseditor.background
用 WebAIM Contrast Checker 输入十六进制色值快速验证。例如：#ffffff（白字）配 #1e1e1e（深灰背）对比度约 14.7:1 ✅；但 #888888（灰字）配同一背景仅 2.3:1 ❌，根本不可读。
注意：插件如 Noctis Lux 或 Ayu Mirage 内置配色多数已过测，但启用后仍建议抽检关键 token 颜色。
插件配置后还需手动补哪些颜色？
即使插件自带高对比主题，UI 区域（非代码区）常被忽略，导致“代码清楚，但侧边栏图标糊成一片”。必须在 settings.json 中补 workbench.colorCustomizations：
-
"workbench.contrastBorder": "#000000"—— 强制所有面板加黑边，解决标签页/终端/侧边栏边界消失问题 -
"activityBar.foreground": "#ffffff"—— 确保左侧图标不发灰 -
"editorSuggestWidget.border": "#444"—— IntelliSense 提示框必须有明确边框，否则悬浮时融进背景 -
"diffEditor.insertedTextBackground": "#a3e63580"—— Git 对比视图新增行带 50% 透明度，既突出又不压住语法色
所有值必须用 #rrggbb 或 #rrggbbaa，red、rgb()、hsl() 全部无效，写了也不生效。
别跳过 editor.tokenColorCustomizations 这一层
很多插件只改 UI，不管代码内 token 颜色。结果关键字、函数名、变量全挤在同一个亮度带里，视觉层次全平。必须单独配 editor.tokenColorCustomizations：
- 深色主题下，避免用
"#ffffff"做字符串色——刺眼且易疲劳；推荐"#ce9178"（暖橙）或"#9cdcfe"（浅蓝） - 注释别用太淡的灰，
"#6a9955"（墨绿）比"#666"更稳、更易区分 - 函数名建议比关键字稍暗一点，形成阅读动线：先抓
if/return，再落点到getData
这一层配错，再好的 UI 主题也白搭——眼睛得在代码里自己找结构。
复杂点不在“怎么配”，而在分清层级：系统高对比模式是总开关，插件主题是载体，workbench.colorCustomizations 是 UI 边界加固，editor.tokenColorCustomizations 是代码语义锚点。漏掉任何一层，对比感都会断档。最容易被忽略的是系统级开关——很多人调了一小时 JSON，最后发现 Windows 高对比根本没开。
