必须安装 shalldie.background 插件，它是目前唯一稳定适配 vscode v1.87+ 的背景图方案；安装后需重启而非重载，路径须用 file:/// 协议且正斜杠，opacity 建议深色主题 0.1–0.15、浅色 0.3，仅推荐配置 background.editor 区域。
插件必须装 shalldie.background，别搜错名字
VSCode 官方不支持背景图，所有可行方案都依赖第三方插件。目前唯一稳定、持续更新、适配 2026 年最新版 VSCode（v1.87+）的，只有 shalldie.background —— 注意作者名是 shalldie，不是 background、vscode-background 或其他变体。搜错名字会装到已停更/报错/闪退的旧版插件，比如某些叫 Custom CSS and JS Loader 的方案，现在根本无法绕过 VSCode 的安全校验。
安装后务必重启 VSCode（不是重载窗口），否则插件 JS 注入逻辑不会触发，配置再对也看不到图。
settings.json 路径写法错一个字符就失效
本地图片必须用 file:// 协议 URI，Windows 路径要三斜杠 + 正斜杠替换，例如：file:///D:/Wallpapers/coding.jpg。常见错误包括：
-
D:\Wallpapers\coding.jpg（缺协议、反斜杠） -
file:/D:/Wallpapers/coding.jpg（少一个/） -
file:///D:\Wallpapers\coding.jpg（反斜杠未转义） -
./coding.jpg或../img/coding.jpg（相对路径完全不支持）
Mac/Linux 用户同理：file:///Users/you/Pictures/bg.png，开头三个 / 不能省。网络图可直接用 https:// 地址，但首次加载慢，且断网时 fallback 不可控。
透明度和定位参数直接影响代码可读性
背景图不是越高清越好，关键是不干扰文字。默认 opacity: 0.3 对多数浅色主题（如 Default Light）仍偏重，容易看不清括号匹配或光标位置；深色主题（如 One Dark Pro）则建议调到 0.1–0.15。
background-size 推荐用 cover（全屏拉伸）或 contain（完整显示），避免 100%,100% 强制拉伸导致人物变形；background-position 建议设为 center 或 50% 50%，防止关键区域（如左上角行号）被遮挡。
示例最小可用配置：
{
"background.enabled": true,
"background.useDefault": false,
"background.customImages": ["file:///D:/bg.jpg"],
"background.style": {
"background-position": "center",
"background-size": "cover",
"background-repeat": "no-repeat",
"opacity": 0.12
}
}
多区域背景要分开配，fullscreen 和 editor 别混用
插件支持 background.editor（仅代码区）、background.sidebar（侧边栏）、background.panel（终端/调试区）、background.fullscreen（整个窗口）。但它们互斥：一旦启用 background.fullscreen，其他区域配置全部失效。
真实使用中，90% 的人只需要 background.editor —— 因为侧边栏和面板区域本身信息密度低，加背景反而分散注意力。若真想分区设置，请确保只启用其中一组，不要同时写 background.fullscreen 和 background.editor，否则行为不可预测。
轮播功能（interval > 0）虽酷，但每次切图都会轻微卡顿，尤其在大文件编辑时，建议日常关闭，仅演示或休息时开启。
最易被忽略的一点：插件修改的是 VSCode 渲染层的 DOM 结构，因此每次 VSCode 自动更新后，首次启动可能弹出「插件需重新激活」提示，点确认即可，不用重装或手动改文件。
