sublime text 4 彻底移除 background_image 字段，因其在代码层已被删除，故直接写入 preferences.sublime-settings 不生效且可能导致设置加载失败；正确方案是使用 material theme 插件或手动编辑 .sublime-theme 文件。
Sublime Text 4 不支持 background_image 字段，直接往 Preferences.sublime-settings 里写它，不仅不生效，还可能让其他设置加载失败。
为什么 background_image 在 ST4 里完全失效
这个字段早在 ST3 后期就被标记为废弃，ST4 彻底移除——不是“没文档”，是代码层已删。所有还在教你填 "background_image": "xxx" 的教程，都基于过时版本。你改了设置、重启、清缓存都没用，是因为 Sublime 根本不解析这一项。
常见错误现象：Preferences → Settings – User 里加了该字段，但背景毫无变化；更糟的是，某些插件或主题会因该无效字段拒绝初始化，导致 UI 异常（如侧边栏空白、标签页不渲染）。
真正起作用的路径只有两条：用支持背景图的主题插件，或手动编辑 .sublime-theme 文件。前者适合想快速出效果的人，后者适合要精确控制图层、透明度、区域范围的用户。
用 Material Theme 插件启用背景图（推荐新手）
Material Theme 是目前唯一持续维护、完整适配 ST4、且把背景图作为 UI 正常组件处理的主题。它不依赖 hack 渲染层，能正确响应深色/浅色模式切换、高 DPI 缩放和多显示器布局。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索并安装Material Theme - 安装后，
Preferences → Themes中选择一个带-Darker或-Lighter后缀的主题（如Material-Theme-Darker） - 打开
Preferences → Settings – User，添加以下三行（缺一不可）：
{
"theme": "Material-Theme-Darker.sublime-theme",
"material_theme_background_panel": true,
"material_theme_background_image": "backgrounds/your-bg.webp"
}
注意：material_theme_background_panel 必须为 true，否则背景图不会渲染；图片需放在 Packages/User/backgrounds/ 目录下（需手动创建）；强烈建议用 .webp 格式——比 PNG 小 60%+，Sublime 解码更稳，且保留 alpha 通道；别用 JPG（丢 alpha）、大尺寸 PNG（拖慢启动）、或绝对路径（插件不认）。
手动修改 .sublime-theme 实现精准图层控制（推荐进阶用户）
如果你需要背景图只出现在编辑区（不覆盖侧边栏/状态栏）、叠加遮罩层、或对不同 UI 区域设不同透明度，就必须改主题文件。核心逻辑是：找到代表画布的 "class": "group" 节点，注入 layer0.texture 和 layer0.opacity。
- 按
Preferences → Browse Packages…，进入Packages/目录，新建文件夹如UserTheme - 复制当前所用主题文件（如
Default.sublime-theme）到该目录，并重命名为UserTheme.sublime-theme - 用 Sublime 打开它，搜索
"class": "group"，在该对象内添加如下字段：
"layer0.texture": "Packages/User/backgrounds/your-bg.webp", "layer0.opacity": 0.15
关键细节：layer0.texture 值必须是 Packages/ 开头的相对路径（不能用 C:/ 或 ~/）；opacity 建议从 0.1–0.25 试起，过高会遮挡文字；若发现图层错位或白屏，大概率是 "class": "group" 找错了位置——有些主题把编辑区单独定义为 "class": "pane" 或 "class": "content"，需针对性查找。
别踩这些坑：WebP 路径、opacity 阈值、图层层级
很多人卡在“图有了但看不清字”或“图一闪就消失”，本质是三个底层限制没被尊重：
-
.webp文件必须放在Packages/User/下某子目录中，且路径写全（如Packages/User/backgrounds/bg.webp）；放桌面或用绝对路径，Sublime 直接静默忽略 -
layer0.opacity低于0.08时，Skia 渲染引擎可能丢帧，表现为背景图闪烁或加载失败；高于0.3则文字可读性骤降，尤其小字号或低分辨率屏 - 图层顺序不可逆：
layer0是最底层，layer1叠在其上；若你同时设了layer0.texture和layer0.tint，后者会盖住前者——想调色得用layer1.tint配合layer1.opacity
最易被忽略的一点：改完 .sublime-theme 后，必须关闭所有 Sublime 窗口再重开，仅保存+重启编辑器不生效——因为主题文件在进程启动时一次性加载进内存，运行中不监听变更。
