VSCode原生不支持背景图,v1.87起禁用Custom CSS方案,唯一稳定方案是shd101wyy发布的Background Cover插件;需配置file:///路径、启用backgroundCover.enabled、设置opacity和style(含pointer-events:none与z-index:99999)并重载窗口。

VSCode 背景图片必须用插件,原生不支持
VSCode 从 v1.87(2026 年)起彻底禁用 Custom CSS 类扩展,所有声称“直接改 CSS 实现背景图”的方案已失效。现在唯一稳定、无需绕过签名、适配最新版的方案是 Background Cover 插件(发布者必须是 shd101wyy)。装错名字相近的插件(比如 vscode-background 或带 Custom CSS 字样的)会导致 Unable to load extension 报错,且静默失败。
安装后必须执行 Developer: Reload Window(不是重启 VSCode 进程,也不是点“重载窗口”按钮),否则 JS 注入层未挂载,配置再对也看不到图。
- 在扩展市场搜
Background Cover,只认准作者shd101wyy - 路径必须用
file:///开头,Windows 是file:///C:/path/to/bg.jpg,Mac/Linux 是file:///Users/you/bg.png,开头的/不能少 - 路径含中文或空格?整个字符串必须用双引号包裹,否则配置静默无效
- 图片格式只推荐
.jpg或.png;避开.webp和.avif;文件大小别超 5MB
settings.json 里这三项不能少,顺序无关但缺一不可
打开 Preferences: Open Settings (JSON),确保编辑的是**用户级**配置(不是工作区),然后写入:
"backgroundCover.enabled": true, "backgroundCover.imagePath": "file:///C:/Pictures/bg.jpg", "backgroundCover.opacity": 0.12
backgroundCover.enabled 是总开关,设为 false 或漏写,其他全白搭;opacity 建议深色主题用 0.05–0.15,浅色主题可到 0.15–0.25;超过 0.3 会导致括号匹配变灰、光标定位困难。
-
backgroundCover.style可选但强烈建议加:"background-size": "cover"(等比填满)、"background-position": "center"(防遮左上角行号)、"pointer-events": "none"(最常被忽略!不加就点不进代码区) - 别写
"background-size": "100% 100%",会强制拉伸变形 -
"z-index": "99999"要加,确保图层在编辑器之下、但高于滚动条
编辑器背景色可直接改,不用换主题
想调背景色又不想动整个主题?直接改 workbench.colorCustomizations 里的 editor.background 就行。它优先级高于当前主题,改完立刻生效,且不影响语法高亮等其他配色。
常见护眼值参考(非纯白更耐看):
-
"editor.background": "#fafafa"—— 极浅灰,柔和不刺眼 -
"editor.background": "#f5f7fa"—— 微蓝调,适合冷光环境 -
"editor.background": "#fdfdfd"—— 几乎是白,但留有余量避疲劳
注意:必须写在 workbench.colorCustomizations 对象内,直接写 "editor.background": "#fff" 无效;如果改了没变化,大概率是 editorGroup.border、sideBar.background 或 terminal.background 还没同步配色,造成视觉割裂。
背景图错位、点不了、代码发灰?先查这三个地方
问题往往不出在图片本身,而在于渲染层级和区域覆盖:
-
pointer-events: "none"漏了?这是“能看见图但点不了代码”的元凶 -
editorGroup.emptyBackground没设?新建未命名文件页签还是默认灰,显得不统一 - 终端或调试控制台背景仍是黑/白?补上
terminal.background和debugToolBar.background配色,否则上下文跳脱
另外,某些插件(如 Bracket Pair Colorizer)会注入样式覆盖你的设置,临时禁用它们验证是否冲突;Windows 上 GPU 加速异常也可能导致颜色渲染错乱,可试 code --disable-gpu 启动排查。


















