vscode没有可配置的启动界面主题图,所谓“自定义启动图”实为混淆workbench.background、editor.background及第三方插件伪背景层;真正起作用的是editor.background(代码编辑区底色),需在workbench.colorcustomizations中配置,推荐值如"#1e1e1e",纯黑易致oled烧屏且对比过强。

VSCode 没有“启动界面主题图”这个概念——它压根不提供可配置的启动页(splash screen)或加载画面,所谓“自定义启动图”,实际是用户混淆了三个完全不同的东西:workbench.background(工作台留白区)、editor.background(代码编辑区底色)、以及第三方插件注入的伪背景层。真正能被你“看到”的首次加载画面,只是 VSCode 启动时渲染的第一个空编辑器窗口,它的视觉表现完全由这三者叠加决定。
为什么改了 workbench.background 却看不到效果?
因为 workbench.background 控制的是侧边栏、状态栏外侧、标签页上方等“非编辑区域”的颜色,不是你打开文件后看到的代码底色。刚启动时如果没打开任何文件,它确实会露出来;但一旦打开一个 .ts 或 .py 文件,焦点立刻落到编辑器上,此时起作用的是 editor.background。
-
workbench.background值必须写在workbench.colorCustomizations里,单独写在 settings.json 根级无效 - 深色主题下推荐值如
"#121212",浅色主题可用"#f8f8f8",避免和editor.background过于接近导致视觉割裂 - 某些图标主题(如
material-icon-theme)会覆盖部分 workbench 区域的背景渲染,造成“改了也不显”的错觉
editor.background 才是你真正该调的参数
这是你每天盯着看的那块代码区域的底色,语法高亮、括号匹配、行高亮都叠在这层之上。调错它,轻则发灰,重则文字直接看不见。
- 必须放在
"workbench.colorCustomizations"的子对象里,例如:{"workbench.colorCustomizations": {"editor.background": "#1e1e1e"}} - 别用纯黑
"#000000":OLED 屏幕易烧屏,且与深色 UI 元素对比过强;推荐"#121212"到"#1e1e1e"区间 - 如果你开了背景图插件(如
background或Background Cover),它的图层默认只覆盖editor.background区域,所以这张图的透明度(opacity)必须配合editor.background色值微调,否则高亮文字会糊成一片
所谓“启动图美化”,其实是靠插件伪造的视觉惯性
VSCode 从 v1.87 开始已彻底禁用 Custom CSS 注入机制,所有试图修改 DOM 结构的旧插件(如 aeschli.vscode-background)基本失效。目前唯一可靠路径是 Background Cover(作者 shd101wyy),但它做的不是替换启动页,而是在编辑器容器上叠一层带 opacity 的 div。
- 路径必须是
file:///开头的绝对路径,Windows 也要用正斜杠:"file:///C:/Users/me/Pics/start-bg.jpg" - 图片若存于 OneDrive/iCloud 同步目录,需确认右下角无云朵图标——VSCode 不读“仅在线”文件
- 配置必须写进用户级
settings.json(命令面板执行Preferences: Open Settings (JSON)确认路径),工作区级设置对首次启动无效
最常被忽略的一点:终端(Terminal)永远不继承编辑器背景,它的颜色由 terminal.integrated.colorScheme 或 shell 配置控制;同理,调试控制台、问题面板、输出面板也各自独立。想让整个界面统一,得挨个配,而不是指望一张图搞定所有。











