VSCode中workbench.colorCustomizations不支持backgroundImage字段，该配置项根本不存在且会被静默忽略；真要添加背景图必须使用插件，当前唯一稳定可用的是shalldie.background，需严格按绝对路径、file:///协议、JSON数组格式及完全重启等要求配置。
workbench.colorCustomizations 里填 backgroundImage 不生效——这个字段根本不存在，VSCode 会静默忽略。真要加背景图，必须用插件，且当前（2026年5月）唯一稳定可用的是 shalldie.background。
为什么 background.enabled 配了还是没图？
最常见原因是路径写错或插件未真正激活：
• background.customImages 必须是数组，哪怕只一张图也要写成 ["file:///C:/bg.jpg"]，末尾多一个逗号会导致 JSON 解析失败
• Windows 路径必须用 file:/// 协议 + 正斜杠，file://C:/bg.jpg（少一个/）或 file:///C:\bg.jpg（反斜杠）都会加载失败
• 路径含中文、空格、括号时，VSCode 不报错但静默失败；建议全英文路径，如 C:/vscode-bg/
• 安装插件后必须完全退出 VSCode（关所有窗口），再重开；仅“重载窗口”不触发插件注入逻辑
• 若右下角显示【不受支持】，需额外安装 Fix VSCode Checksums 并运行 Fix Checksums: Apply
background.style 里哪些字段最关键？
它不是 CSS 简写，而是逐项声明的样式对象，漏掉关键项就会错位或遮挡：
• "opacity": 0.12：深色主题建议 0.1–0.15，浅色主题可到 0.25；超过 0.3 基本看不清括号匹配高亮
• "pointer-events": "none"：必须写，否则鼠标悬停代码上会触发图片层拦截点击，光标变手型、无法选中文字
• "background-size": "cover"：比 100% 100% 安全，避免人物/Logo 拉伸变形；contain 适合小图但易留白
• "background-position": "center" 或 "50% 50%"：防止左上角行号被关键图案遮挡
• 别写 z-index 过高（如 "999999"），可能盖住折叠箭头或断点图标
怎么让终端和侧边栏也透出同一张图？
默认只有编辑器主区域有背景，终端和侧边栏仍是纯色块，视觉割裂。要统一，得补两处独立配置：
• 终端透明："terminal.integrated.background": "#00000000"（四个零代表完全透明）
• 侧边栏透明："workbench.colorCustomizations": {"sideBar.background": "#00000000"}
• 这两项必须和 background.* 同级，不能嵌套进 background.style 里
• 注意：如果用了主题插件（如 One Dark Pro），它可能在 workbench.colorCustomizations 里强行重写 sideBar.background，得手动覆盖或禁用其背景相关设置
多显示器或缩放后图片模糊/错位怎么办？
这不是配置问题，是 Electron 渲染层与 DOM 伪元素不同步导致的固有限制：
• 高 DPI 屏幕下，图片发虚通常因插件未做像素对齐；换 2x 分辨率图（如 7680×4320）效果略好，但无法根治
• 缩放 125% 或 150% 后错位，说明你配了 background.fullscreen 或 background.sidebar；这些区域渲染逻辑和编辑器不同，强烈建议只启用 background.editor 区域
• 多显示器不同缩放比例时，背景图只按主屏 DPI 渲染，副屏必然模糊——目前无绕过方案，只能接受或换纯色背景
