vscode原生不支持背景图片，所有生效背景图均来自插件注入的css层；workbench.colorcustomizations中backgroundimage配置项根本不存在，vscode仅识别颜色字段如workbench.background，填url会静默忽略；当前唯一稳定插件是shalldie.background，需用file:///协议绝对路径、启用pointer-events:"none"并完全重启vscode。
VSCode 原生不支持背景图片，所有“生效”的背景图都来自插件注入的 CSS 层；硬改 workbench.colorCustomizations 里塞 backgroundImage、手动编辑 editor.css 或往 workbench.html 塞 base64，全都会静默失败或重启清空。
为什么 workbench.colorCustomizations 里加 backgroundImage 没用
这个配置项根本不存在。VSCode 解析 workbench.colorCustomizations 时只认颜色字段（如 workbench.background、editor.background），遇到 backgroundImage 直接跳过——控制台不报错，也不加载图片。网上流传的示例多是早期误传或混淆了其他编辑器的配置语法。
-
workbench.background只接受颜色值："#1e1e1e"、rgb(30, 30, 30)、transparent，填 URL 会失效 -
editor.background同理，它是纯色层，不是容器，无法承载图片 - 想调纯色背景？直接配这两项就行，不用插件
当前（2026 年）唯一稳定可用的插件是 shalldie.background
截至 2026 年 4 月，Background Cover、vscode-background 等老牌插件在 VS Code v1.87+ 中普遍触发 Unable to load extension 或被 Electron 安全策略拦截。shalldie.background 是目前唯一通过签名验证、不注入 JS、仅用合法伪元素叠加的方案。
- 安装后必须**完全退出 VS Code**（不是重载窗口），再重新打开，否则不生效
- 路径必须用
file:///协议 + 正斜杠：Windows 写成file:///C:/bg/code.jpg，不能用C:\bg\code.jpg或./bg.jpg - 路径中不能含中文、空格、括号；macOS/Linux 需确保 VS Code 有磁盘读取权限（系统设置 → 隐私与安全性 → 完全磁盘访问）
- 核心配置只有三行，缺一不可：
"background.enabled": true、"background.customImages": ["file:///..."]、"background.style": {...}
background.style 里必须写 pointer-events: "none"
漏掉这一项，鼠标悬停在代码上会触发图片层捕获点击事件，导致光标失焦、折叠图标点不动、右键菜单打不开——现象像“编辑器卡死”，实际是 CSS 层挡住了交互。
-
"pointer-events": "none"是安全底线，别为了调模糊效果删掉它 -
opacity建议深色主题设0.1–0.15，浅色主题可到0.25；超过0.3会盖住括号匹配高亮和行号 -
background-size推荐"cover"（等比铺满）或"contain"（完整显示），避免"100% 100%"拉伸变形 - 多显示器或高 DPI 下发虚？不是插件问题，是 Electron 渲染未对齐像素，换低分辨率图或接受轻微模糊
终端和侧边栏怎么透出背景图
shalldie.background 默认只作用于编辑器主区域（.monaco-editor），终端和侧边栏仍是纯色块。要视觉统一，得手动透底：
- 终端透明：
"terminal.integrated.background": "#00000000"（四个零 = 完全透明） - 侧边栏透明：
"workbench.colorCustomizations": {"sideBar.background": "#00000000"} - 这两项必须和
background.*平级写在settings.json里，不能嵌进background.style - 注意：透底后若文字反差不足，需同步调暗/调亮主题色，否则阅读吃力
真正难的不是配参数，而是路径协议、权限、插件签名这三关卡住 90% 的人；一旦跑通，后续换图只是改一行 background.customImages 路径的事。
