VSCode主题配色必须通过workbench.colorCustomizations配置生效，不可仅靠更换主题；它需作为settings.json顶层字段，键名须为官方color token（如sideBar.background），值须为完整十六进制色值（如#1e1e1e），且受主题覆盖时需显式重写，改完需重启窗口才能刷新activityBar.activeBackground等状态色。
VSCode 主题配色不能靠“换主题”解决，必须改 workbench.colorCustomizations —— 否则连编辑器边框、活动标签页底色、侧边栏焦点态都动不了。
为什么改了 settings.json 还没生效？
常见错误是把颜色配置写在了错误位置，或被已启用的主题 CSS 覆盖：
-
workbench.colorCustomizations必须是settings.json顶层字段，不能嵌套在其他对象里 - 如果同时启用了第三方主题（比如
One Dark Pro），它可能通过themeColor强制覆盖部分颜色项，此时需加!important的等效处理——实际做法是用workbench.colorCustomizations显式重写对应 key - 颜色值不支持缩写（如
#fff），必须写满 6 位或带 alpha 的 8 位（#ffffff00） - 改完保存后要重启 VSCode 窗口（不是重载窗口），否则
activityBar.activeBackground等部分状态色不刷新
workbench.colorCustomizations 常用 key 列表
这些是真正影响日常视觉体验的最小必要集，不是全量罗列：
-
editor.background：编辑区底色（注意：不等于主题默认背景，它会覆盖主题设定） -
editor.foreground：普通文字颜色（高亮/注释等由语法 token 决定，不归这里管） -
editorCursor.foreground：光标颜色（别设成和背景太近，否则看不见） -
activityBar.background：左侧图标栏背景 -
activityBar.activeBackground：当前活动视图（如 Explorer）的图标底色 -
tab.activeBackground：顶部当前打开文件 tab 的背景（常被忽略，但最影响聚焦感） -
sideBar.background：资源管理器/搜索/调试等侧边栏背景 -
statusBar.background：底部状态栏背景（含 Git 分支、编码格式等信息）
完整 key 可查官方文档：workbench.colorRegistry，但 90% 场景只动上面 8 个就够了。
如何让自定义颜色适配暗色/亮色模式自动切换？
VSCode 不支持 media query，但支持按主题条件加载不同配置：
- 在
settings.json中用"[Default Dark+]": { ... }或"[GitHub Dark]": { ... }包裹对应颜色块 - key 名必须和已启用主题的 ID 完全一致（可去
~/.vscode/extensions/下主题包的package.json查id字段） - 不要试图用
if (isDark)或 JS 表达式——VSCode settings 是纯 JSON，不执行逻辑 - 示例片段：
"[Default Dark+]": { "editor.background": "#1e1e1e", "tab.activeBackground": "#252526" }, "[Default Light+]": { "editor.background": "#ffffff", "tab.activeBackground": "#f0f0f0" }注意：括号和引号一个都不能少，且必须是双引号。
改完发现某些区域颜色还是不对？检查这三点
颜色异常往往不是配置错，而是优先级或作用域理解偏差：
-
editorLineNumber.foreground和editorLineNumber.activeForeground是两回事，后者控制当前行号颜色，常被漏设 - 终端（Terminal）颜色由
terminal.ansi*系列控制，和编辑器颜色完全隔离，例如terminal.ansiBlue不受editor.foreground影响 - 代码高亮（syntax highlighting）由语言扩展 + TextMate grammar 决定，
workbench.colorCustomizations对它无效；想调函数名/字符串颜色，得改editor.tokenColorCustomizations
真正难的不是写对颜色值，而是分清「UI 控件色」「编辑器语义色」「终端 ANSI 色」「语法 token 色」这四层边界——跨层混改只会越调越乱。
-
