editor.tokenColorCustomizations更关键，因它专管if、"hello"、// comment等语法元素颜色，需按精确scope（如string.quoted.double.python）配置，而workbench.colorCustomizations仅控制状态栏、侧边栏等非编辑区UI色。
为什么editor.tokenColorCustomizations比workbench.colorCustomizations更关键
改代码颜色，不是调UI界面——workbench.colorCustomizations只管状态栏、侧边栏、标签页这些非编辑区；真正影响你读代码的，是editor.tokenColorCustomizations。它专管if、"hello"、// comment这类语法元素的颜色，且必须按 scope（比如string.quoted.double.python）来写，不能靠语言名或主题名硬猜。
常见错误现象：改了"editor.foreground"却发现函数名没变色——说明主题启用了 semantic token（语义高亮），此时editor.foreground已被绕过，强行覆盖会破坏整套语义体系。
- 验证 scope 的方法：把光标停在目标代码上，按
Ctrl+Shift+P→ 输入Developer: Inspect Editor Tokens and Scopes - scope 是层级结构，优先匹配最细粒度的，比如
support.function.builtin.python比support.function.python优先级更高 - 第三方主题（如 Nord）常自带 token 配置，若发现你的设置不生效，检查是否开了
"nord.enforceSyntaxHighlighting": true，关掉它
editor.background明度值别乱填，20–35 是生理舒适区间
OLED 屏上纯黑#000000会让白色文字边缘泛光；LCD 屏则容易显脏灰。实测人眼长时间阅读最不累的背景明度，对应 LCH 色彩空间的 L 值 20–35，换算成十六进制大约是 #1e1e1e 到 #2d2d2d。
Dark+ 的 #1e1e1e（L≈22）偏暗发沉；One Dark Pro 的 #282c34（L≈35）带轻微蓝灰倾向，视觉更通透——这不是“好看”，是瞳孔调节负荷更低。
- 别在
workbench.colorCustomizations里写"editor.background"，它属于编辑器区域，必须放在editor.tokenColorCustomizations的顶层作用域 - 如果用了 Material Icon Theme，记得加配置：
"material-icon-theme.folders.color": "#6c5ce7"，否则图标深色会压住浅色文字 - 工作区
.vscode/settings.json中若锁定了"workbench.colorTheme"，用户级设置会被覆盖，得先检查这个
注释和字符串颜色怎么选才不抢戏
注释不是“次要信息”，而是视觉锚点。用橙红等高唤醒色（如 #ff6b35）会让大脑误判为警告，打断阅读流。优先选灰阶系：#5c6370 或 #6272a4，饱和度低、明度适中，退居背景但又清晰可辨。
字符串色太亮（如 #ff9800）会跳出来干扰逻辑流；太暗（如 #888）又难识别。推荐带冷调的中亮度色，比如 #98c379（绿）、#61afef（蓝），既区分于关键字，又不刺眼。
- 避免用
comments这种宽泛 scope，尽量细化到comment.line.double-slash.cpp或comment.block.documentation.python - 如果某语言注释不生效，可能是该语言扩展未启用 semantic token 支持，此时得回退到传统 TextMate scope 规则
- 别给所有字符串统一配色——Python 的 f-string 插值部分（
${var}）应单独设为变量色，否则语义混淆
装了主题≠用了主题，启动路径必须走对
很多用户装完 One Dark Pro 就以为生效了，结果还在用 Dark+。VSCode 不自动切换，必须手动激活：按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux），输入 Preferences: Color Theme，从列表里选中它。
主题切换是运行时行为，改完配置不用重启，但必须确保当前窗口没被工作区设置锁定。如果 .vscode/settings.json 里有 "workbench.colorTheme": "Dark+"，那就算你在用户设置里选了别的主题，也无效。
- 检查是否被工作区覆盖：打开命令面板 → 输入
Preferences: Open Workspace Settings (JSON)，看有没有workbench.colorTheme字段 - 主题启用后，按
Ctrl+K Ctrl+T可快速呼出主题切换面板，实时预览 - 某些主题（如 Dracula Official）默认开启 bold 关键字，若字体渲染糊，需同步关掉
"editor.fontWeight": "normal"
真正护眼的配色，不在“暗”或“亮”的二分法里，而在背景明度、注释饱和度、token 语义层级这三者的精确咬合——少调一个参数，就可能让眼睛多花 10% 的调节力。
