VSCode原生不支持背景图，唯一稳定方案是安装适配v1.87+的shalldie.background插件；因其通过签名验证、合法CSS伪元素叠加，不注入JS，兼容最新安全策略，而旧插件多被Electron拦截失效。
VSCode 原生不支持背景图，硬改 CSS 或塞 workbench.colorCustomizations 里的 backgroundImage 字段完全无效——这个配置项根本不存在，VSCode 会静默忽略。唯一稳定可用的路径是安装兼容当前版本（v1.87+）的 shalldie.background 插件，并严格按其规则配置。
为什么必须用 shalldie.background，而不是其他 background 插件？
多数旧版 background 插件（如 mindginative.vscode-background）已在 VSCode v1.85+ 后被 Electron 渲染策略拦截，启动时直接报“不受支持”或空白失效；shalldie.background 是目前唯一通过签名验证、适配最新安全模型的方案。它不注入外部 JS，只通过合法 CSS 伪元素叠加图层，不影响语法高亮、折叠、光标定位等任何功能。
- 插件市场搜
shalldie.background，认准作者名shalldie，别装错成同名但无签名的 fork 版 - 安装后必须 完整重启 VSCode（不是重载窗口），否则背景不会出现
- 若重启后标题栏仍显示【不受支持】，需额外安装
Fix VSCode Checksums并运行Fix Checksums: Apply
settings.json 中必须写的三行核心配置
只配这三项就能让图显示出来，其余全是可选微调。路径、协议、斜杠方向错一个，图片就加载失败。
-
"background.enabled": true—— 总开关，缺了整个插件不工作 -
"background.customImages": ["file:///C:/Users/xxx/Pictures/bg.jpg"]—— 必须用file://协议，正斜杠/，Windows 下也不能用反斜杠\；路径中不能含中文、空格、括号 -
"background.style": {"opacity": 0.12, "pointer-events": "none", "background-size": "cover"}——opacity建议深色主题设为0.1–0.15，浅色主题可到0.3；pointer-events: "none"必须写，否则鼠标悬停在代码上会触发图片层拦截点击
让终端和侧边栏也透出背景图的 trick
默认只有编辑器主区域有图，终端和侧边栏仍是纯色块，视觉割裂。要统一风格，得手动透底：
- 终端变透明：
"terminal.integrated.background": "#00000000"（四个零代表完全透明） - 侧边栏变透明：
"workbench.colorCustomizations": {"sideBar.background": "#00000000"} - 注意：这两项写在和
background.*同级的位置，不要嵌套进background.style里
常见失效原因与绕过方式
背景图突然消失，90% 是以下三个原因导致，逐一排查比重装插件快得多：
- 路径用了相对路径（如
"./bg.jpg"）或变量（如${userHome}）——shalldie.background不支持这些，只认绝对file://地址 - 图片放在 OneDrive / iCloud / 微信/QQ 默认下载目录下——这些路径常含空格或同步符号，VSCode 无法解析
- 显卡驱动老旧（尤其 Intel HD 4000/5000 系列），开启
opacity+blur会触发 Electron 渲染撕裂，文字发虚；此时应关闭所有 blur 相关样式，仅保留opacity和background-size
最稳的做法：把图单独存到 C:/VSCodeBg/ 这类全英文无空格路径下，用资源管理器复制完整地址，粘贴进 customImages，然后彻底退出 VSCode 再打开。
