vs code 原生不支持背景图片,唯一稳定方案是 shalldie.background 插件(v1.87+),需用 file:/// 绝对路径配置 background.editor,避免中文、空格、括号,深色主题 opacity 推荐 0.10–0.15。

VS Code 原生不支持背景图片,所有“生效”的背景都是插件在 DOM 上层注入的 div + background-image 实现的——直接改 workbench.background 或 editor.background 的 CSS 值完全无效。
只用 shalldie.background 插件(v1.87+ 唯一稳定方案)
截至 2026 年 8 月,background(michelemelluso)、Background Cover 等插件在 VS Code v1.87+ 中大概率报 Unable to load extension 或被自动禁用。目前唯一稳定适配的是 shalldie.background。
- 必须完全退出 VS Code(不是重载窗口),再重启才能生效
- 安装后不要点“启用”,它默认激活;若失效,检查是否被安全策略拦截
- 插件市场搜
shalldie.background,认准作者名和最新更新时间(2026 年内)
settings.json 配置必须用 file:/// 绝对路径
路径格式错误是 90% 无法显示背景的根源。Windows 必须写成 file:///C:/bg/code.jpg,不能用 C:\bg\code.jpg 或相对路径。
- 路径中严禁中文、空格、括号(如
我的图片.jpg、D:/VS Code/bg.jpg都会失败) - 推荐把图放到
C:/vscode-bg/或/Users/you/Pictures/vscode-bg/这类干净路径 - Mac/Linux 用户注意:
file:///后是根目录,所以file:///Users/you/bg.jpg才对,不是file://Users/...
只配 background.editor 区域最稳妥
侧边栏(background.sidebar)、面板(background.panel)等区域在缩放 125% 或高 DPI 屏幕下极易拉伸失真,且新版 Electron 渲染层叠加易触发文字发虚。
- 专注代码区即可,配置示例:
"background.enabled": true"background.editor": { "images": ["file:///C:/vscode-bg/tech.jpg"], "opacity": 0.12, "size": "cover", "position": "center" }- 深色主题建议
opacity设为0.10–0.15,浅色主题可到0.20–0.25;超过0.3会盖住括号匹配高亮
真正麻烦的不是配置本身,而是路径协议、透明度阈值、渲染层冲突这三点——调好一张图后复制粘贴到其他区域,大概率因缩放或 DPI 触发视觉异常。不如先守住编辑器主区,稳了再试其他。











