editor.background是唯一直接控制代码编辑区底色的配置项；常见失效原因包括工作区设置、冲突主题插件或workbench.colorcustomizations格式错误，需检查配置位置、大小写及颜色格式，并同步调整editor.foreground确保可读性。
editor.background 是唯一能直接控制代码编辑区底色的配置项，改它就对了。其他路径全是绕路，比如试图靠换主题、调终端背景或改 workbench.colorCustomizations 里的非 editor 相关字段来“间接影响”，基本无效。
为什么改了 editor.background 却没变？先查这三处
不是配置写错了，而是被更高优先级设置盖掉了：
- 检查
.vscode/settings.json（工作区级）是否写了同名配置——它会完全屏蔽用户级设置 - 确认没装冲突主题插件，比如 One Dark Pro、Nord 或某些“暗黑增强”类扩展，它们常通过
editor.tokenColorCustomizations强制接管渲染逻辑 - 系统开启了深色模式但当前主题（如 GitHub Theme）依赖该开关，系统没开暗色，它就回退到亮色变体，
editor.background值再对也白搭
workbench.colorCustomizations 怎么配才不静默失效
这个对象是改 UI 颜色的唯一入口，但极易因格式错误被 VSCode 忽略（不报错，只静默跳过）：
- 必须是
settings.json顶层字段，和"editor.fontSize"并列，不能嵌在editor.tokenColorCustomizations或其他对象里 - 键名大小写敏感：
sideBar.background不是sidebar.background，漏一个大写就失效 - 值推荐用
"#1e1e1e"这类十六进制，避免hsl()或darkgray—— macOS 和 Windows 渲染偏差大，浅灰背景文字边缘容易发虚 - 如果已有
workbench.colorCustomizations，直接往里面加键值，别重复声明整个对象
配完 editor.background 后代码看不清？同步调这两个
背景变了，但前景色（文字）和 token 颜色没动，视觉就崩了：
- 必须同步设
editor.foreground，比如背景是"#1e1e1e"，前景建议用"#d4d4d4"或更亮的"#e0e0e0" - 检查是否启用了带
editor.tokenColorCustomizations的主题，它可能把字符串、注释等颜色压得太暗；可临时禁用主题插件验证 - 若想微调语法色（比如让
"string"更醒目），得走editor.tokenColorCustomizations+textMateRules路径，不是往workbench.colorCustomizations里塞
终端、侧边栏、状态栏怎么协调不割裂？
单独调 editor.background 容易造成视觉断层，建议批量配色：
- 侧边栏用
sideBar.background，值比编辑器深 5–10%，比如编辑器是"#1e1e1e"，侧边栏设"#1a1a1a" - 状态栏用
statusBar.background，可略亮一点（"#252525"），方便区分底部信息区域 - 终端背景必须单独配
terminal.integrated.background，它和editor.background完全无关——别指望改一个会联动另一个 - 所有这些都得塞进同一个
workbench.colorCustomizations对象里，漏逗号或引号会导致整段失效
