workbench.colorCustomizations 是唯一真正生效的编辑界面颜色设置入口，其他方式无法精确控制各区域颜色；常见失效原因包括工作区配置覆盖、主题锁定、错误嵌套、拼写错误；推荐按灰阶梯度协同配置 editor.background、sideBar.background、statusBar.background 等，并同步调整 foreground、cursor、selection 等以保障可读性与一致性。
workbench.colorCustomizations 是唯一真正生效的编辑界面颜色设置入口，其他方式（比如点菜单换主题、改设置 UI 里的滑块、手动编辑 CSS 文件）都不能精确控制编辑器背景、侧边栏、状态栏等区域的颜色。
为什么改了 editor.background 却没变色
常见失效不是写错了值，而是被更高优先级或更隐蔽的配置覆盖：
-
.vscode/settings.json（工作区级）里有同名配置，会直接屏蔽用户级设置；建议先临时删掉它测试 - 当前启用的主题（如
Nord或GitHub Theme）内部锁定了editor.background，尤其在系统未开启暗色模式时自动回退到亮色变体 -
workbench.colorCustomizations被错误嵌套在"workbench":{}或"editor":{}里——它必须是settings.json的顶层字段 - 拼写错误：大小写敏感，
sideBar.background有效，sidebar.background或SideBar.background全部无效
怎么配才不割裂：编辑器 + 侧边栏 + 状态栏协同调色
单独调 editor.background 容易让整个界面像拼贴画。推荐按灰阶梯度统一协调：
- 编辑器背景用
"editor.background": "#1e1e1e"（深灰） - 侧边栏略深一点：
"sideBar.background": "#1a1a1a"（比编辑器深约 5%） - 状态栏稍亮：
"statusBar.background": "#252525"（方便区分底部信息） - 终端背景必须单独设：
"terminal.integrated.background": "#1e1e1e"，它和编辑器背景完全无关 - 所有值优先用十六进制（如
#1e1e1e），避免hsl()或命名色（darkgray在 macOS/Windows 渲染偏差大）
配完代码看不清？别只调 background
背景变深后，文字如果还是默认浅灰（#d4d4d4）就容易发虚或对比度不足。必须同步调整：
-
"editor.foreground": "#cccccc"（比默认稍亮，保可读性） -
"editorCursor.foreground": "#569cd6"（蓝色光标，在深灰底上比白色更醒目） -
"editor.selectionBackground": "#264f78"（选中文本用偏蓝的深色，避免和背景融成一片） - 如果用了行高亮，别漏掉：
"editor.lineHighlightBackground": "#2a2d2e"（比背景略深，否则高亮不明显）
最常被忽略的是：改完 workbench.colorCustomizations 后，如果某个 UI 区域仍没响应，大概率是 DOM class 名和 color token 不对应——必须用 Developer: Toggle Developer Tools 右键 inspect 元素，再查官方 color reference 文档确认 token 名，不能靠猜。
