直接修改 workbench.colorCustomizations 中的 editor.background 即可控制代码编辑区底色，它必须位于 settings.json 顶层，且需同步调整 editor.foreground、editorCursor.foreground 和 editor.tokenColorCustomizations 以确保可读性与视觉协调。
直接改 editor.background 就行，别绕路
VSCode 里唯一能直接控制代码编辑区底色的配置项就是 editor.background。不是主题名、不是插件开关、也不是 workbench.colorCustomizations 里的其他字段——它就是那个“一锤定音”的键。你改它，编辑器背景就变；不生效，说明被更高优先级的配置盖住了，而不是写错了位置。
常见失效场景：
-
.vscode/settings.json（工作区级）里写了同名配置，会完全覆盖用户级设置 - 装了 One Dark Pro、Dracula 等带
editor.tokenColorCustomizations的主题插件，它们可能间接重写 UI 渲染逻辑 -
workbench.colorCustomizations已存在，但你新写的editor.background没放在这个对象里，而是单独写在顶层——VSCode 会静默忽略
workbench.colorCustomizations 必须是顶层对象
所有界面颜色（侧边栏、状态栏、标签页、括号高亮背景等）都得走 workbench.colorCustomizations 这个入口，但它不能嵌套，不能缩进，不能藏在别的字段下面。它必须和 "editor.fontSize"、"files.autoSave" 并列，出现在 settings.json 的最外层。
正确写法示例：
{
"editor.fontSize": 14,
"workbench.colorCustomizations": {
"editor.background": "#282c34",
"sideBar.background": "#1e2127",
"statusBar.background": "#007acc",
"editorBracketMatch.background": "#3a3a3a"
}
}
容易踩的坑：
- 漏掉逗号或引号，整个
workbench.colorCustomizations区块失效，VSCode 不报错，只当它不存在 - 写成
workbench.colorcustomizations（小写 c）或workBench（大小写混），键名大小写敏感，配了也白配 - 值用了
hsl(210, 10%, 20%)或darkgray，跨平台渲染偏差大，尤其 macOS 上文字边缘容易发虚
改完背景色后代码看不清？同步调 editor.foreground 和 token 颜色
只改 editor.background 而不调前景色，大概率导致文字灰蒙蒙、注释看不见、关键字糊成一片。这不是颜色选得不好，是默认文本色没跟着适配。
必须同步处理三类颜色：
-
editor.foreground：控制所有未被语法高亮覆盖的普通文本颜色，建议用#d4d4d4这类中高亮度灰 -
editorCursor.foreground：光标颜色，太淡会找不到，太亮又刺眼，#aeafad是个折中选择 -
editor.tokenColorCustomizations：专门管语法高亮，比如"comments": "#647f4c"、"strings": "#d6994b"，scope 必须精准（如string.quoted.double.python），不能笼统写string
注意：editor.tokenColorCustomizations 和 workbench.colorCustomizations 是并列关系，不是父子关系，别把它塞进后者里面。
终端、侧边栏、状态栏颜色要协调，别只盯编辑器
单独调 editor.background 容易造成视觉割裂：编辑区是豆沙绿，侧边栏却是纯黑，一眼看上去像两个应用拼在一起。真正舒服的配色是梯度过渡的。
推荐配比逻辑（以深色系为例）：
- 编辑器背景：
#282c34（主视觉区域，亮度居中） - 侧边栏背景：
#1e2127（比编辑器深 5–10%，强化层级感） - 状态栏背景：
#007acc或#252525（略亮或带品牌色，方便区分底部信息） - 终端背景：
terminal.integrated.background必须单独设，它和editor.background完全无关，别指望联动
括号匹配背景（editorBracketMatch.background）也归 workbench.colorCustomizations 管，不是语法高亮——很多人搜 “bracket color” 却去配 tokenColorCustomizations，结果怎么都改不动。
