workbench.colorCustomizations 是唯一稳定修改 VSCode 工作区 UI 颜色的配置项，但需注意作用域、顺序和主题兼容性；常见失效原因包括 JSON 格式错误、第三方主题强制覆盖、字段层级错误、color ID 写错及未适配终端、Markdown、调试控制台等组件。
workbench.colorCustomizations是唯一能稳定修改 VSCode 工作区 UI 颜色的配置项，改它就对了——但必须注意作用域、顺序和主题兼容性，否则改了等于没改。
为什么改了 workbench.colorCustomizations 没生效？
常见现象：保存 settings.json 后侧边栏还是灰的、状态栏颜色没变、甚至整个编辑器卡在浅色模式。
- JSON 格式错误：多一个逗号、少一个引号、括号不匹配——VSCode 设置面板右下角会报红，但常被忽略；建议粘贴进在线 JSON 校验工具（如 jsonlint.com）快速排查
- 当前主题“锁死”了颜色：部分第三方主题（如 Nord、Dracula Official）在 package.json 中设了
"_defaults": true，会强制覆盖用户自定义；临时换回Dark+ (default dark)或Light+验证是否生效 - 字段写错层级：必须是顶级字段，不能嵌套在
editor或files下；也不能放在editor.tokenColorCustomizations里——那是管代码高亮的，不是 UI - 配错 color ID：比如想改标签页背景，却写了
"tab.background"（错误），正确是"tab.activeBackground"或"tab.inactiveBackground"；完整列表见 VSCode 官方文档或运行Developer: Generate Color Theme From Current Settings
workbench.colorCustomizations 常用 color ID 对照表
别靠猜，这几个是最常调、也最容易踩坑的：
-
"editor.background"：仅控制代码编辑区域背景，不影响侧边栏、状态栏等其他区域 -
"workbench.background"：控制整个工作区背景（即编辑器+侧边栏+底部空白区），但不包括活动栏（activityBar）、标题栏（titleBar） -
"sideBar.background"：侧边栏（资源管理器、搜索、调试等面板）背景色，独立于workbench.background -
"statusBar.background"：底部状态栏背景；若用了"statusBar.noFolderBackground"，记得一并设，否则打开空文件夹时会突兀变色 -
"activityBar.background"：左侧图标栏（文件资源管理器、搜索、Git 等入口）背景；默认透明，设成深色时务必同步调"activityBar.foreground"，否则图标看不见
如何让深色主题真正“统一”，不割裂？
只改 workbench.colorCustomizations 还不够。UI 变暗了，但终端、Markdown 预览、调试控制台可能还是白的，视觉断层严重。
- 终端必须单独配：
"terminal.integrated.colorScheme": "Default Dark+"（不是靠继承主题） - Markdown 预览默认走浏览器样式，加这行：
"markdown.preview.fontSize": 14+"markdown.preview.fontFamily": "'Segoe UI', -apple-system, BlinkMacSystemFont"，再配合 CSS 注入扩展（如 Custom CSS and JS Loader）微调背景 - 调试控制台颜色由
debug.console相关 color ID 控制，比如"debugConsole.background"和"debugConsole.infoForeground"，不设就沿用编辑器默认 - 别忽略
contrastBorder：加"workbench.contrastBorder": "#333"能强化面板边界，尤其在深灰背景上区分侧边栏与编辑器，比纯靠色差更可靠
容易被忽略的细节：透明度、缩放与多显示器
改完颜色后，在高 DPI 屏（如 MacBook Pro 16" 或 Windows 200% 缩放）上可能发虚、发灰或文字边缘模糊。
- 避免用纯黑
#000000：深色主题推荐#121212～#1e1e1e，保留一点灰度反而更护眼、渲染更稳 - 带 alpha 的十六进制值（如
#1e1e1eCC）在workbench.colorCustomizations中无效——它只接受不带透明度的标准格式；透明效果得靠主题自身支持（如某些支持 opacity 的 UI 扩展） - 多显示器场景下，macOS 用户要注意：如果外接显示器为低色域（sRGB），而主屏是 P3，同一组颜色在两屏上观感差异极大；建议用系统级色彩校准工具统一预设，而非仅靠 hex 值硬调
- 改完别急着截图发朋友圈——先开一个新窗口（
File > New Window），确认所有子区域（终端、调试、设置页）都同步变色，才算真正落地
