workbench.colorCustomizations是唯一真正起效的VSCode界面颜色定制入口，必须作为settings.json顶层字段配置，键名大小写敏感、值为合法CSS颜色字符串，且需区分UI色与语法色；改后通常实时生效，但部分状态相关key需重启窗口。
改 VSCode 界面颜色，workbench.colorCustomizations 是唯一真正起效的入口；其他任何方式——点菜单换主题、手动改 CSS 文件、在设置 UI 里调滑块——都无法精确控制状态栏、侧边栏、活动标签页等关键区域的颜色。
为什么改了 settings.json 还没变色
90% 是配置位置或格式错了：
-
workbench.colorCustomizations必须是settings.json的顶层字段，不能嵌套在"editor"或"workbench"对象里 - 键名大小写敏感：
sideBar.background有效，sidebar.background完全无效 - 值必须是合法 CSS 颜色字符串：
"#2d2d2d"、"rgba(45, 45, 45, 0.9)"可用；"red"、"hsl(0,0%,50%)"、var(--vscode-editor-background)全部不生效 - 第三方主题（如 One Dark Pro）可能内部重写了部分颜色，此时需显式在
workbench.colorCustomizations中覆盖对应 key，而不是指望它“继承”
workbench.colorCustomizations 常用 key 怎么选
别查全表，先盯住这 7 个真正影响日常聚焦感的项：
-
editor.background：仅控制编辑器文字区底色（不是整个窗口），和终端背景terminal.background无关 -
tab.activeBackground：当前打开文件 tab 的背景色；tab.activeBorder才是底部那条高亮线 -
sideBar.background：资源管理器/搜索/调试等侧边栏背景；sideBarSectionHeader.foreground控制顶部“EXPLORER”这类文字色，不是sideBar.foreground -
statusBar.background：右下角 Git 分支、编码格式、行号那一整条的背景 -
activityBar.background：左侧图标栏背景；activityBar.activeBackground是当前选中视图（如搜索）的图标底色 -
editorCursor.foreground：光标颜色，设成和editor.background太接近会直接看不见 -
editor.lineHighlightBackground：当前行高亮背景，不是行号列背景（那是editorLineNumber.foreground）
如何精准找到某个 UI 元素对应的颜色 key
靠猜或搜文档效率极低，正确路径只有一条：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），运行Developer: Toggle Developer Tools - 右键点击目标区域（比如状态栏右侧的 Git 分支名），选
Inspect - 看 DOM class 名（如
status-bar-item、monaco-workbench），再对照官方 theme color reference 映射到标准 key - 注意：DOM class 和 color token 不是一一对应的，
status-bar-item→statusBar.foreground，不是statusBarItem.foreground
改完要不要重启 VSCode
大部分颜色实时生效，但以下情况必须重启窗口（不是重载）：
-
activityBar.activeBackground、tab.inactiveBackground等带状态的 key，首次设置或修改后需重启才刷新 - 同时启用了多个主题扩展（如 Nord + One Dark Pro），它们可能在启动阶段竞争覆盖，重启可强制清空缓存态
- 你在工作区级
.vscode/settings.json里写了workbench.colorCustomizations，它会完全屏蔽用户级设置，重启才能确认是否真被加载
真正容易被忽略的是：workbench.colorCustomizations 和 editor.tokenColorCustomizations 彻底隔离——前者动 UI，后者动代码语法高亮；混写在一个对象里，VS Code 会静默忽略所有 UI 相关 key。
