直接改workbench.colorcustomizations才算真正生效，换主题包仅切换预设；其必须置于settings.json顶层、键名严格匹配官方token、值为完整十六进制或rgba格式，且受第三方主题覆盖时需显式重写，改完须重启窗口而非仅重载。
直接改 workbench.colorCustomizations 才算真正生效，换主题包只是切换预设，连侧边栏焦点色、活动标签底色都动不了。
为什么改了 settings.json 还是没变颜色？
常见失效不是因为写错颜色值，而是配置没落到位或被覆盖：
-
workbench.colorCustomizations必须是settings.json的顶层字段，不能塞进"editor"或"workbench"对象里 - 第三方主题（比如
One Dark Pro）会用内部themeColor强制接管部分 UI 元素，此时必须显式重写对应 key，例如activityBar.activeBackground - 颜色值不支持缩写（
#fff无效），必须是 6 位（#1e1e1e）或带 alpha 的 8 位（#1e1e1e80） - 改完保存后要「重启窗口」（
Developer: Reload Window不够），否则像tab.activeBackground这类状态色不会刷新
哪些 color token 最值得优先改？
日常视觉影响最大、又最容易被默认主题忽略的 7 个 key：
-
editor.background：编辑区底色，决定整体明暗基调 -
editor.foreground：普通文本色，和语法高亮无关，只管非 token 文字 -
editorCursor.foreground：光标颜色，别设成和背景太接近（比如深灰背景配#252526就看不见） -
activityBar.background：左侧图标栏背景 -
activityBar.activeBackground：当前活动视图（如 Explorer）图标的底色 -
tab.activeBackground：顶部当前文件 tab 的背景，直接影响聚焦感 -
statusBar.background：底部状态栏背景，Git 分支、编码格式等信息全靠它衬托
其他如 sideBar.background、panel.background 可按需补充，但上面 7 个已覆盖 90% 的视觉干扰点。
如何让自定义颜色适配暗/亮主题自动切换？
VSCode 不支持 CSS media query，但支持条件块语法——靠主题 ID 匹配：
- 在
settings.json里用"[Default Dark+]": { ... }或"[GitHub Light]": { ... }包裹对应配置 - ID 必须和已启用主题的
package.json中id字段完全一致（可去~/.vscode/extensions/下对应主题目录查） - 不能写 JS 表达式（比如
if (isDark)），settings.json 是纯 JSON，不执行逻辑 - 多个条件块可以共存，VSCode 会自动加载匹配当前激活主题的那个
示例：
{
"[Default Dark+]": {
"editor.background": "#1e1e1e",
"tab.activeBackground": "#2d2d2d"
},
"[Default Light+]": {
"editor.background": "#ffffff",
"tab.activeBackground": "#f0f0f0"
}
}
最常被忽略的是：activityBar.activeBackground 和 tab.activeBackground 这两个状态色，它们不随 editor.background 变化而联动，必须单独指定；还有 alpha 通道的支持——很多用户想加半透效果却卡在写错格式上。
