vscode 背景图必须通过 background 插件实现，直接修改 workbench.background 无效；需手动编辑 settings.json 配置各区域（editor/sidebar/panel/fullscreen）的 file:// 路径及样式，保存后完全退出并重启，再运行 fix vscode checksums 命令解除签名校验限制。
VSCode 背景图靠插件，不是改 workbench.background
直接改 workbench.colorCustomizations 里的 workbench.background 只能设纯色或渐变，**填图片路径无效**——VSCode 官方不支持该字段解析图片 URL。你看到的“背景图”效果，全依赖第三方插件实现，目前最稳定、更新最勤的是 background 插件（作者：aaron-bond），别被同名低星插件误导。
安装插件后必须编辑 settings.json，图形界面设置不生效
插件安装完，点设置 → 搜索 “background”，界面里能看到几个开关，但**只有 background.enabled 和 background.useDefault 能勾选，其余全得手写 JSON**。图形界面点“在 settings.json 中编辑”才是正路，否则配置等于没配。
-
background.customImages必须用file://协议，Windows 路径如"file:///C:/pics/bg.jpg"（注意三斜杠，盘符大写，反斜杠全换成正斜杠） - Mac/Linux 要写成
"file:///Users/you/pics/bg.png"，不能省略/开头 - 路径中含空格或中文？没问题，但必须用双引号包裹，JSON 语法不能破
- 多张图可填数组，但 VSCode 当前只轮播 Editor 区域，Sidebar/Panel 全屏等区域需单独配（见下一条）
Editor、Sidebar、Fullscreen 是独立区域，配置不互通
插件把背景拆成 4 个作用域：editor（代码编辑区）、sidebar（资源管理器/搜索侧边栏）、panel（底部终端/调试输出）、fullscreen（整个窗口，含标题栏）。它们的配置项前缀不同，比如：
- 编辑区背景：用
background.customImages+background.style - 侧边栏背景：得写
background.sidebar.customImages和background.sidebar.style - 全屏背景：必须用
background.fullscreen.customImages，且**一旦启用，其他区域配置会被遮盖，建议注释掉 editor 等配置再试**
常见错误是只配了 background.customImages，结果只有编辑区有图，侧边栏还是灰的——因为没配 background.sidebar.*。
重启才生效，且可能报“不受支持”，要装 Fix VSCode Checksums
改完 settings.json 保存，必须完全退出 VSCode（关所有窗口），再重开。否则背景不会刷新。更麻烦的是：VSCode 2024 年底起加强了扩展签名校验，background 插件因修改底层 DOM 会被标为“不受支持”，右下角弹黄标，背景也不显示。
- 解决方法：装插件
Fix VSCode Checksums - 按
Ctrl+Shift+P输入Fix Checksums: Apply回车 - 再重启 VSCode（不是重载窗口）
这步漏掉，等于前面全白干；而很多人卡在“明明配对了怎么没反应”，其实就差这一条命令。
