Sublime Text 4 中 background_image 字段已被彻底移除，任何在 settings 中设置均无效且可能引发 UI 渲染异常；需改用 Material Theme 插件或手动编辑 .sublime-theme 文件实现背景图。
background_image 字段在 Sublime Text 4 中已彻底移除，任何在 Preferences.sublime-settings 里写它的方式都不会生效，还可能让侧边栏空白、标签页不渲染，甚至阻断其他插件初始化。
为什么改了 settings 还没背景图？
这不是路径或格式问题，是字段本身已被代码层删除——ST4 启动时直接忽略该键，不报错也不加载。网上大量教程仍沿用 ST2/ST3 的写法，导致你反复重启、清缓存、换路径都无效。
- 常见错误现象：
Preferences → Settings – User里加了"background_image": "xxx"，但编辑区、侧边栏、状态栏全无变化 - 更隐蔽的问题：某些主题（如 Ayu、Seti_UI）会因检测到未知字段而跳过整个 UI 渲染流程，表现为侧边栏变空、文件树消失、右键菜单异常
- 验证方式：按
Ctrl+`打开控制台，搜索background_image相关日志——如果完全没出现，说明 Sublime 根本没读这一项
用 Material Theme 插件启用背景图（新手首选）
Material Theme 是目前唯一持续适配 ST4、把背景图作为原生 UI 组件处理的主题，不依赖 hack 渲染层，能正确响应深色/浅色模式切换和高 DPI 缩放。
- 安装后必须在
Preferences → Settings – User中同时设置三项："theme"（指定 .sublime-theme 文件名）、"material_theme_background_panel"（必须为true，否则图层被跳过）、"material_theme_background_image"（相对路径，起点是Packages/User/） - 图片必须放在
Packages/User/backgrounds/目录下（需手动创建），不能放项目根目录或绝对路径 - 只支持
.webp和带 alpha 通道的.png；.jpg会丢透明度，大尺寸.png显著拖慢启动 - 示例配置：
{
"theme": "Material-Theme-Darker.sublime-theme",
"material_theme_background_panel": true,
"material_theme_background_image": "backgrounds/bg.webp"
}
手动修改 .sublime-theme 实现图层精准控制（进阶用户）
如果你需要背景图仅出现在编辑区（不覆盖侧边栏/状态栏）、叠加遮罩层、或单独控制透明度，就必须编辑主题文件。核心是定位 "class": "group" 节点（代表整个编辑窗口画布），注入 layer0.texture 和 layer0.opacity。
- 路径操作：按
Preferences → Browse Packages…→ 进入Packages/User/→ 新建文件夹如UserTheme/→ 复制当前主题文件（如Default.sublime-theme）进去并重命名 - 编辑时搜索
"class": "group"，在其对象内添加："layer0.texture": "UserTheme/bg.webp"（路径相对于Packages/）、"layer0.opacity": 0.15（建议 0.05–0.2，过高影响文字可读性） - 若要限制图层只作用于编辑区，不覆盖行号或折叠标记，需找
"class": "view_container"而非"group" - 注意：
layer0.texture不支持 URL 或绝对路径，只认Packages/下的相对路径；WebP 比 PNG 解码更稳，强烈优先选用
别踩 color_scheme 里的 background_image 陷阱
有资料提到可在 .sublime-color-scheme 的 globals 块里加 background_image，这在 ST4 中同样无效——color scheme 只控制文字区域颜色与语法高亮，**不处理任何图片资源加载逻辑**。即使你写对了绝对路径，Sublime 也不会解析该字段，控制台也不会报错，只是静默忽略。
真正容易被忽略的是：背景图效果是否稳定，取决于主题插件或 .sublime-theme 文件是否完整接管了渲染流程。用第三方主题时，务必确认其文档明确声明“ST4 native support”；手动改 theme 时，别只改一个节点就保存——"group" 下的 layer0 配置必须成对出现，缺 opacity 或 texture 都会导致整块 UI 渲染失败。
