Sublime Text 4 中 background_image 字段已被彻底移除，直接写入 Preferences.sublime-settings 无效且可能导致设置加载失败；唯一可靠方案是使用 Material Theme 插件并满足三项硬性条件：material_theme_background_panel 必须为 true、material_theme_background_image 路径需以 Packages/User/ 为起点、图片须存放于 Packages/User/backgrounds/ 且仅支持 .webp 或带 alpha 的 .png。
Sublime Text 4 里根本不能靠写 background_image 字段加背景图——这个字段早在 2022 年就从核心移除了，硬写进 Preferences.sublime-settings 不仅无效，还可能让设置加载失败。
Material Theme 背景图不显示？检查这三处硬性条件
Material Theme 是目前唯一在 ST4 下能稳定启用背景图的方案，但必须同时满足三个条件：
-
material_theme_background_panel必须设为true，否则整个背景图层被跳过 -
material_theme_background_image的值是相对路径，起点是Packages/User/，不是项目目录或 Sublime 安装目录 - 图片必须放在
Packages/User/backgrounds/（需手动创建该文件夹），且仅支持.webp或带 alpha 通道的.png；.jpg会丢透明度，大尺寸.png显著拖慢启动
验证路径是否正确：按 Ctrl+Shift+P → 输入 Preferences: Browse Packages → 进入 User/ 目录 → 手动建 backgrounds/ 文件夹 → 放入 bg.webp → 在 Settings – User 中添加：
{
"material_theme_background_panel": true,
"material_theme_background_image": "backgrounds/bg.webp"
}
保存后重启。若仍不生效，按 Ctrl+` 打开控制台，搜 Unable to load background image —— 出现即说明路径错。
想只给编辑区贴图？别碰 .sublime-theme
有人试图在 .sublime-theme 里给 class: "view" 节点加 layer0.texture 实现“仅编辑区背景图”，这在 ST4 下不可行。Skia 渲染引擎已屏蔽该节点的纹理注入，强行添加会导致 UI 白屏或主题加载失败。
真正可用的替代方式只有两种：
- 用
color_scheme的background_image字段（仅作用于文字区域），但路径必须是绝对路径，例如："background_image": "C:/sublime/bg.png" - 放弃图片，改用低对比纯色 +
background_opacity（如0.92），视觉更稳、兼容性更好
为什么侧边栏还是默认色？theme 和 color_scheme 各管一摊
color_scheme 只影响编辑区——背景、语法高亮、光标等；它对侧边栏、标签页、状态栏完全无效。这些 UI 元素由 theme 控制，修改位置完全不同：
- 侧边栏背景色在
.sublime-theme文件中搜索"class": "sidebar_container"，改"layer0.tint"对应的 RGB 数组，例如[232, 245, 232] - 路径大小写敏感：
"theme": "Packages/User/MyTheme.sublime-theme"写成mytheme或漏掉Packages/前缀，Sublime 就当没这回事 - 改完保存后，部分 UI（如树状目录背景）需关闭再开新窗口才刷新，不是实时生效
背景图路径错误、theme/color_scheme 混用、XML/JSON 格式误配、大小写拼错——这些细节不会报红，只会默默退回默认样式，查起来特别费时间。
