background_image字段在Sublime Text 4中已完全移除，直接写入Preferences.sublime-settings无效；Material Theme需手动启用material_theme_background_panel并严格按路径、格式、目录结构配置才生效。
background_image 字段在 Sublime Text 4 中已完全失效，任何直接往 Preferences.sublime-settings 里写 "background_image": "xxx" 的做法都不会显示图片，还可能干扰设置加载。
为什么装了 Material Theme 却没背景图？
Material Theme 默认不开启背景图渲染，必须手动打开开关，且路径、格式、目录结构三者缺一不可：
-
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） - 再进
Preferences → Settings – User，加这两行（注意逗号和引号）：
{
"material_theme_background_panel": true,
"material_theme_background_image": "backgrounds/bg.webp"
}
保存后重启 Sublime；如果仍不生效，打开控制台（Ctrl+`）看有没有 Unable to load background image 报错——有就说明路径错了。
想让背景图只出现在编辑区？别碰 theme 文件
有人想改 .sublime-theme 实现“仅编辑区贴图”，但 Sublime Text 4 的 Skia 渲染引擎已屏蔽对 class: "view" 节点的 layer0.texture 注入，强行添加会导致 UI 白屏或主题加载失败。
真正可行的替代方案只有两种：
- 用
color_scheme的background_image（仅作用于文字区域，路径必须是绝对路径，如C:/sublime/bg.png） - 放弃图片，改用低对比纯色 + 柔和
background_opacity（比如0.92），视觉上更稳、兼容性更好
所有声称“全局窗口级背景图”或“侧边栏+编辑区统一贴图”的方案，在 ST4 下均不可靠，本质是混淆了 UI 主题、配色方案、系统窗口层级三者的权限边界。
