workbench.colorCustomizations覆盖侧边栏、活动标签页、状态栏、活动栏、编辑器组标题等UI背景与前景色，但不控制图标、字体、圆角或系统级标题栏；须严格按官方token名（如tab.activeBackground）配置，大小写与下划线不可错，且需置于正确JSON嵌套结构内。
workbench.colorCustomizations 覆盖哪些 UI 元素
它能改的是 VSCode 工作台（Workbench）所有带颜色的视觉组件，比如侧边栏背景、活动标签页底边、状态栏文字、搜索框边框、按钮悬停色等。但不能改图标、间距、圆角、字体或窗口标题栏——这些属于 Electron 渲染层或系统级控件，workbench.colorCustomizations 无权接管。
如何写对 token 名称避免“改了没反应”
token 名称必须和官方文档完全一致，大小写、下划线、拼写都不能错。常见误写包括：tab.activeBackground 写成 tabActiveBackground，或把 statusBar.foreground 错写为 statusBar.fontColor。建议直接查 VS Code 官方文档中 “Workbench Color Tokens” 列表，不要靠记忆或猜测。
-
activityBar.background控制左侧活动栏整体背景色 -
tab.activeBorder是标签页底部那条高亮线，不是背景 -
editorGroupHeader.tabsBackground影响多编辑器组顶部标签区域背景 - 所有 token 都是字符串键，值必须是十六进制色值（如
"#2D2D2D"）或null（重置为默认）
为什么修改后部分区域颜色没变
优先级冲突是最常见原因：第三方主题（如 One Dark Pro）本身已定义大量 token，会覆盖你写的部分配置。如果你只改了 statusBar.background 却发现没生效，大概率是主题里也定义了同名 token，且它的值优先级更高。
- 用命令面板执行
Developer: Inspect Editor Tokens and Scopes，把光标停在目标 UI 区域上，可实时看到当前生效的 token 名和来源 - 想强制覆盖，必须确保你的
workbench.colorCustomizations在settings.json中存在，且未被扩展或策略设置屏蔽 - 某些 token（如
window.activeBorder）在 macOS 上无效，因窗口边框由系统绘制 - 远程开发（SSH/WSL）环境下，该配置需同步到远端
settings.json才生效
批量调整时容易忽略的关键点
批量写入多个 token 时，最常漏掉的是语义分组结构。VS Code 要求 workbench.colorCustomizations 是一个对象，而不能平铺写一堆键值对。
正确格式必须是：
{
"workbench.colorCustomizations": {
"activityBar.background": "#1E1E1E",
"statusBar.background": "#007ACC",
"tab.activeBorder": "#007ACC"
}
}
如果漏掉外层大括号，或把 workbench.colorCustomizations 写成数组、嵌套错层，VS Code 会静默忽略整个块，且不报错。
另外，深色主题下过度提高对比度（比如让 editor.foreground 用纯白配深灰背景）反而伤眼，真正影响体验的往往是边缘细节：状态栏是否透出 Git 分支色、搜索框获得焦点时边框是否明显、折叠箭头是否足够清晰——这些比主色调更值得花时间调。
