Sublime Text 4 已彻底移除 background_image 字段，直接在设置中添加无效；唯一可靠方案是使用 Material Theme 插件并严格满足四项配置条件，或手动编辑 .sublime-theme 文件注入 layer0.texture。
Sublime Text 4 里直接写 background_image 字段完全无效，不是路径不对、不是没重启、不是图片格式错——这个字段在代码层已被删除，Sublime 启动时直接忽略它，还可能让侧边栏空白或插件不加载。
为什么 Preferences → Settings 里加 background_image 没反应
这是最常踩的坑：网上大量 ST2/ST3 教程还在教你在 Preferences.sublime-settings 里写 "background_image": "xxx"。ST4 已彻底移除该字段，控制台里搜不到任何相关日志，UI 渲染流程甚至会因检测到未知键而跳过整个主题初始化。
常见现象包括：
- 编辑区、侧边栏、状态栏全无变化
- 文件树消失、右键菜单异常、标签页不渲染
- 某些主题（如 Ayu、Seti_UI）直接拒绝加载 UI
验证方式：按 Ctrl+` 打开控制台，输入 view.settings().get("background_image") —— 返回 None 就说明 Sublime 根本没解析这一项。
用 Material Theme 插件启用背景图（新手唯一靠谱方案）
Material Theme 是目前唯一持续适配 ST4、把背景图作为原生 UI 组件处理的主题，不依赖 hack 渲染层，能响应深色/浅色模式切换和高 DPI 缩放。
必须同时满足以下四点才生效：
- 安装后在
Preferences → Themes中选一个带-Darker或-Lighter后缀的主题（如Material-Theme-Darker.sublime-theme） - 在
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/，新建文件夹如UserTheme - 复制当前所用主题（如
Default.sublime-theme）到该目录并重命名（如UserTheme.sublime-theme） - 在
"class": "group"下添加："layer0.texture": "Packages/User/backgrounds/bg.webp", "layer0.opacity": 0.15
- 保存后，在
Settings – User中将"theme"改为"UserTheme.sublime-theme"
注意：layer0.texture 的路径支持 Packages/ 开头的相对路径，但不支持 ~ 或 C:/ 这类绝对路径；opacity 建议设在 0.1–0.25 之间，太高会影响文字可读性。
别碰 color scheme 的 background_image（除非你只要 content 区域）
有人尝试在 .sublime-color-scheme 的 globals 里加 background_image，这确实能生效，但仅作用于纯文字区域（content area），不覆盖行号、折叠标记、迷你地图等——视觉割裂感强，且路径必须是绝对路径（C:/xxx 或 /Users/xxx），跨设备无法同步。
更麻烦的是：background_image_stretch 只支持 "stretch"、"repeat"、"center" 三种模式，无法做模糊、遮罩、渐变叠加等精细控制；若图片带 alpha，容易导致文字边缘发虚。
所以除非你明确只要“文字底下那块区域”有图，否则这条路既难维护又易出错。
真正关键的细节藏在路径和格式里：图片必须放对位置、必须用 WebP、material_theme_background_panel 必须显式设为 true——少一个，背景图就永远出不来。ST4 的设计逻辑变了，旧思路不管用，得按新规则来。
