editor.background是唯一直接控制代码编辑区背景色的配置项；若未生效，常见原因是工作区设置、冲突主题插件或workbench.colorcustomizations格式错误覆盖，需检查配置位置、嵌套结构及同步调整前景色与语法高亮。
editor.background 是唯一能直接控制代码编辑区背景色的配置项，改它就对了。其他路径——比如调主题、改 workbench.colorCustomizations 外层结构、或者去 UI 设置里翻找“背景色”选项——全是绕路或无效操作。
为什么 settings.json 里写了 editor.background 却没生效
不是语法错，而是被更高优先级的配置盖掉了：
- 检查是否在项目根目录下的
.vscode/settings.json（工作区级）里写了同名配置——它会完全屏蔽用户级设置 - 确认没装冲突主题插件，比如 One Dark Pro、Dracula 或某些“暗黑增强”类扩展，它们常在内部硬编码
editor.background，且优先级高于workbench.colorCustomizations -
workbench.colorCustomizations必须是顶层对象，不能嵌套在"settings"或其他字段下；已有该字段时，只往里面加键值对，别重复声明整个对象 - 远程开发（如 Remote-SSH、WSL）场景下，要确保改的是远程窗口里的
settings.json（右下角显示「Remote」时再打开设置）
workbench.colorCustomizations 的正确写法和常见坑
必须把 editor.background 放进这个对象里，单独写在 settings 顶层是无效的：
{
"workbench.colorCustomizations": {
"editor.background": "#1e1e1e",
"sideBar.background": "#1a1a1a",
"terminal.integrated.background": "#0d0d0d"
}
}
- 所有键名必须是 VSCode 官方定义的 color token，比如
editor.background，不能拼错成editorBackground或editor-bg - 值推荐用纯十六进制（
#1e1e1e），避免用rgb()、hsl()或命名色（如darkgray），后者在 macOS/Windows 渲染不一致，易导致文字边缘发虚 - 逗号遗漏、引号不闭合、多了一个逗号结尾——VSCode 不报错，只是静默忽略整个
workbench.colorCustomizations对象
终端、侧边栏、状态栏背景色怎么同步配
editor.background 只管编辑器中间区域，其他区域完全无关，必须单独配：
- 终端背景：必须设
terminal.integrated.background，UI 设置里搜到的“Terminal > Background”全是只读展示，不能点选 - 侧边栏背景：
sideBar.background，建议比editor.background深 5–10%，视觉上更稳重 - 状态栏背景：
statusBar.background，可略亮一点（如#252525），方便区分底部信息 - 新建未保存文件页签背景：
editorGroup.emptyBackground，不设它会导致空白页签仍是默认灰，显得割裂
改完背景色后代码看不清，怎么办
这不是背景设错了，是前景色和语法高亮没同步调：
- 先确认
editor.foreground是否合理（比如深色背景配浅灰文字#d4d4d4） - 如果用了自定义语法高亮（
editor.tokenColorCustomizations），检查comments、strings、keywords等是否仍适配新背景，尤其注意字符串在深灰底上用浅黄可能对比度不足 - PowerShell 用户特别注意：Windows 下若终端还是白底，大概率是
$PROFILE里设置了$Host.UI.RawUI.BackgroundColor，它会强行覆盖terminal.integrated.background
