workbench.colorCustomizations 仅在当前作用域生效，不支持继承，优先级为工作区设置 > 用户设置 > 内置默认值；修改后部分UI颜色需Reload Window才能刷新。
workbench.colorCustomizations 为什么只在当前设置生效
它本身不支持“继承”，而是直接覆盖当前作用域下的颜色值。你改的是用户级 settings.json，就影响所有工作区；改的是项目根目录 .vscode/settings.json，就只对这个工作区生效。没有父子工作区自动继承这回事——VSCode 不会把父文件夹的配色透传给子文件夹。
常见错误是把自定义颜色写进全局 settings.json，结果所有项目都套用同一套深灰背景，但某个 Python 项目其实需要浅底+高对比注释。这时候得手动在该工作区的 .vscode/settings.json 里重写 workbench.colorCustomizations，覆盖掉全局值。
- 优先级顺序：工作区设置 > 用户设置 > 内置主题默认值
- 如果两个 settings.json 都定义了
"editor.background"，以工作区那个为准 - 删除工作区配置中的某一项（比如删掉
"statusBar.background"），它不会回退到用户设置，而是回落到当前激活主题的原始值
如何让多个工作区共享一套配色但允许局部微调
靠 JSON 的结构特性实现“伪继承”：把通用配色抽成基础对象，再用扩展运算符（VSCode 1.85+ 支持）或复制粘贴方式复用。VSCode 本身不解析 JS，所以不能直接写 const base = {...}，但你可以人工维护一个模板片段。
例如，在团队项目中统一侧边栏和状态栏颜色，但每个子项目编辑器背景不同：
{
"workbench.colorCustomizations": {
"sideBar.background": "#252526",
"statusBar.background": "#007acc",
"editor.background": "#1e1e1e"
}
}
把这个块存为 snippet 或文档，新工作区创建时复制进去，只改最后一行 "editor.background" 即可。别指望 VSCode 自动合并，它只认最终合并后的 JSON 对象。
- 不要在
.vscode/settings.json里引用外部文件——VSCode 不支持 import 或 $ref - 同步建议用 Git submodule 或脚本生成，而不是靠编辑器机制
- 如果用了 Settings Sync，注意它默认同步用户设置，工作区设置需额外勾选“Workspace settings”
theme 切换后 workbench.colorCustomizations 还生效吗
生效，但可能被主题内部定义的颜色令牌覆盖。VSCode 渲染颜色时走的是“三层叠加”流程：内置默认 → 主题 colors 字段 → workbench.colorCustomizations。只要你的键名和主题里定义的完全一致（比如都用 "editor.background"），你的值就一定赢。
容易踩的坑是主题自己改了键名语义。比如某些第三方主题把 "editor.background" 当作“代码区主背景”，却把 "editorGroup.background" 用作标签页背景——如果你只配了前者，切到那个主题后，标签页可能还是白的。
- 确认主题是否锁定了部分颜色：有些主题在
package.json里声明"restricted": true，此时workbench.colorCustomizations对某些键无效 - 用命令
Developer: Inspect Editor Tokens and Scopes看不到界面元素的颜色键名，得查主题源码或文档 - 最稳的方式：先切到目标主题，再打开
settings.json增量添加定制项，边加边看效果
为什么改了 colorCustomizations 没反应，但 reload window 就好了
因为部分颜色（尤其是涉及布局容器的，如 "activityBar.background"、"titleBar.activeBackground"）依赖 UI 初始化阶段读取，运行时修改只触发局部重绘，而某些容器尺寸或层级关系没刷新。这不是 bug，是 VSCode 渲染管线的设计限制。
不是每次都要 reload，但以下情况大概率需要：
- 首次添加
workbench.colorCustomizations节点 - 从空对象变成非空对象（比如之前是
{}，现在填了值） - 修改了影响窗口 chrome 的颜色（标题栏、活动栏、状态栏）
其他多数编辑器区域颜色（如 "editor.foreground"、"editorCursor.foreground"）改完保存即生效，不用重启。
