真正护眼又耐看的暗色配色需同时管控UI区域色、语法token色、字体渲染和插件干扰四条线，仅换主题名或单改一层配置必然割裂。
VSCode 暗黑主题配色不是换一个名字就完事——默认的 Dark+ 实际背景是 #1e1e1e，不是纯黑；多数“高颜值”主题靠堆砌饱和色博眼球，写两百行后眼睛发胀。真正护眼又耐看的暗色配色，得同时控住 UI 区域色、语法 token 色、字体渲染和插件干扰这四条线。
为什么直接选主题总不如预期
常见错误现象：装了 One Dark Pro 或 Dracula，编辑区看着还行，但侧边栏、状态栏还是灰扑扑的；或者注释淡得看不见，模板字符串和普通字符串颜色一样，调试时根本分不清。
- VSCode 的主题系统分两层：
workbench.colorCustomizations管界面（侧边栏、标签页、状态栏等），editor.tokenColorCustomizations管代码着色（comment、string、keyword等），只改一层，必然割裂 - 很多第三方主题没填全
tokenColors，尤其对新语法（如 TS 的using、JSX 中的jsx.attribute）支持滞后 - 某些语言扩展（如 Pylance、ESLint 插件）会注入自己的高亮规则，覆盖你手动设的颜色，且不进
tokenColorCustomizations白名单
怎么用 settings.json 安全微调暗色配色
比装一堆“主题增强”插件更稳，修改后实时生效，升级不丢失。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），搜Preferences: Open Settings (JSON) - 只加你需要的部分，比如想压暗侧边栏又提亮注释：
{ "workbench.colorCustomizations": { "sideBar.background": "#1a1a1a", "activityBar.background": "#161616" }, "editor.tokenColorCustomizations": { "comments": "#777", "strings": "#ce9178", "keywords": "#c586c0" } } -
workbench.colorCustomizations的 key 必须是官方 color ID（查法：Ctrl+Shift+P→Developer: Generate Color Theme From Current Settings） -
editor.tokenColorCustomizations的值不支持简写十六进制（如#fff），必须写满六位（#ffffff）或带 alpha 的八位（#ffffffcc）
如何精准拿到某个语法元素的着色 scope
想改 console.log 的颜色，但不知道该配哪个 scope？别猜，用 VSCode 自带工具定位。
- 把光标停在目标代码上（例如
log），按Ctrl+Shift+P（macOS 是Cmd+Shift+P） - 输入并运行
Developer: Inspect Editor Tokens and Scopes - 面板里会显示完整 scope 链，比如：
support.function.console.js→support.function.js→support.function - 优先用最具体的那个（顶部第一个），避免误配全局规则；不同语言插件注册的 scope 不同，JavaScript 的
function和 Python 的functionscope 完全不通用
OLED 屏幕用户必须关掉的两个视觉干扰点
纯黑背景在 OLED 上本该让像素彻底熄灭，但 VSCode 默认会在活动标签页和状态栏按钮上加细微描边或渐变，导致不该亮的像素还在发光。
- 补上这两项配置，才能实现真黑省电：
"workbench.colorCustomizations": { "tab.activeBorder": "#000000", "statusBar.noFolderBackground": "#000000" } - 同时禁用所有带“高亮”“彩虹”字样的插件（如
Bracket Pair Colorizer、Rainbow Brackets），它们的描边逻辑绕过 colorCustomizations，只能卸载或重写其 token 规则 - 如果用了
Peacock或Theme Switcher这类主题管理插件，它们可能劫持workbench.colorCustomizations，临时禁用再测试
复杂点在于：UI 色和语法色要同步调，而语法色又依赖语言插件是否暴露了足够细的 scope；OLED 真黑还得额外关掉那些“看不见的描边”，这些细节不处理，再好看的截图也撑不过半小时编码。
