直接修改 settings.json 中的 images 数组即可实时更换 VS Code 背景图,路径须为 file:// 协议绝对路径(Windows 为 file:///C:/...,macOS/Linux 为 file:///Users/...)或 HTTPS 在线地址,相对路径无效;多图轮播按数组顺序播放,支持 opacity、size、position 等微调以适配新图。

直接改 settings.json 里的 images 数组就行,不用重装插件、不用重启 VS Code,改完保存就生效。
换图只需改 images 数组,路径必须是绝对路径
vscode-background 插件识别图片靠的是 background.editor.images(或其他区域如 background.sidebar.images)这个数组。它接受字符串列表,每个字符串是一个图片地址。
- 本地图片必须用
file://协议 + 绝对路径:Windows 是file:///C:/Users/name/Pic.jpg(注意三个斜杠,盘符后一个),macOS/Linux 是file:///Users/name/Pictures/bg.png - 相对路径(比如
"./bg.jpg")或不带协议的路径(比如"C:/bg.jpg")一律无效,插件会静默忽略 - 在线图片必须是 HTTPS 地址,HTTP 会被浏览器策略拦截,控制台报
Refused to load the image - 支持多种格式:
.jpg、.png、.webp、.gif(动图仅在轮播时有效),不推荐.bmp或未压缩大图,加载慢还拖拽卡顿
opacity 和 size 不随图片换,但得留意它们是否还合适
换新图后,旧的 opacity 值可能不匹配——比如深色图配 0.2 透明度刚好,换成浅色图就可能遮不住文字;size: "cover" 在宽高比差异大的图上会裁剪严重,导致关键内容被切掉。
- 如果文字变模糊或发灰,优先调低
opacity(试 0.1–0.15) - 想保留完整构图,把
size改成"contain",但注意四周可能留白;"100% 100%"会拉伸变形,慎用 - 配合
position微调,比如"center top"把重点往上托,避免被状态栏遮挡
多图轮播时,删图/加图顺序决定显示逻辑
如果你启用了轮播(interval > 0),images 数组的顺序就是默认播放顺序;设了 random: true 才打乱。
- 删图:直接从数组里移除对应字符串,不需要清空整个数组
- 加图:往数组里 push 新路径,支持混合类型,例如同时写本地路径和 HTTPS 链接
- 轮播间隔单位是秒,
interval: 30表示每 30 秒切一张,太短(如 5)会导致频繁重绘,高 DPI 屏幕下易出现短暂模糊
真正容易被忽略的是:插件不会校验图片是否存在或可读。路径写错、文件被移动、权限不足,它都只沉默跳过——结果就是背景突然变空白或回退到默认色块,此时要打开开发者工具(Help → Toggle Developer Tools),看 Console 有没有 Failed to load resource 报错,再核对路径。











