workbench.colorCustomizations 必须作为顶层字段写在 settings.json 根对象下，嵌套在 editor、workbench 或 settings 内均无效；修改后需重启窗口而非重载，且需同步配置 tab.* 与 editorGroupHeader.tabsBackground 等关联项以确保视觉统一。
workbench.colorCustomizations 必须写在 settings.json 顶层
改了颜色但没反应？八成是配置位置错了。VSCode 只认 workbench.colorCustomizations 作为顶层字段，不能嵌在 "editor" 或 "workbench" 对象里，也不能包在 "settings" 键下面。常见错误写法：
-
"editor": { "colorCustomizations": { ... } }❌ -
"workbench": { "colorCustomizations": { ... } }❌ -
"settings": { "workbench.colorCustomizations": { ... } }❌
正确写法就是直接平铺在 settings.json 根对象下：
{
"workbench.colorCustomizations": {
"tab.activeBackground": "#2d3748",
"tab.inactiveBackground": "#1a202c",
"tab.hoverBackground": "#4a5568"
}
}
改完必须重启 VSCode 窗口（不是重载），否则像 activityBar.activeBackground 这类状态色不会更新。
tab.activeBackground 和 tab.inactiveBackground 是最该配的两个
顶部 Tab 的视觉层次感全靠它俩拉开。很多人只配 tab.activeBackground，结果非活动 Tab 和背景融为一体，根本分不清哪几个文件开着。实际中建议同步设置：
-
tab.activeBackground：当前聚焦文件的 Tab 底色（别太亮，否则刺眼） -
tab.inactiveBackground：其他已打开文件的 Tab 底色（要比 active 暗 1–2 个灰阶） -
tab.hoverBackground：鼠标悬停时临时提亮，增强反馈 -
tab.activeForeground和tab.inactiveForeground：文字颜色也要对应调整，避免灰底配浅灰字
注意：tab.border 默认透明，加个 #374151 能让 Tab 分隔更清晰；但别设 tab.unfocusedActiveBackground——这个 key 已废弃，VSCode 2025 年后不再识别。
editorGroupHeader.tabsBackground 不等于 tab.*，但它影响整组 Tab 区域
如果你用多编辑器组（比如拖文件到右侧新建组），tab.* 配置只管单个 Tab 的底色，而 editorGroupHeader.tabsBackground 控制的是整个顶部 Tab 栏的容器背景。它常被忽略，但一旦设错，会出现“Tab 有颜色、但 Tab 上方留白一块灰色”的割裂感。
- 当
editorGroupHeader.tabsBackground比tab.activeBackground浅时，Tab 会像“浮”在背景上 - 设成和
tab.inactiveBackground一致，能获得更统一的视觉区块 - 这个值不响应鼠标悬停或焦点切换，是静态背景，适合做底层基调
它和 tab.* 是叠加关系，不是替代关系——必须两者都配，才能让多组编辑器下的 Tab 行看起来干净。
状态色如 statusBar.debuggingBackground 容易被主题覆盖
你设了 statusBar.background，但一进调试模式，状态栏突然变蓝？那是 statusBar.debuggingBackground 在起作用。VSCode 对不同状态有独立 color token，它们互不继承，必须显式声明：
-
statusBar.background：常态 -
statusBar.debuggingBackground：F5 启动调试时 -
statusBar.prominentBackground：有未保存文件或 Git 冲突时 -
statusBar.noFolderBackground：刚打开 VSCode、还没打开文件夹时
第三方主题（比如 One Dark Pro）常会强制重写这些 key，所以哪怕你配了，也可能被盖掉。唯一可靠做法：在 workbench.colorCustomizations 里把这四个全列出来，值保持逻辑一致（比如 debug 状态比常态深 10%），避免突兀跳变。
真正难的不是写对 key，而是理解哪些状态色会被动态触发、哪些会被主题劫持、哪些改了要重启窗口——这些细节不试几次根本记不住。
