Sublime Text 4 中 background_image 已被移除，有效方案只有两种：使用 Material Theme 等支持背景图的第三方主题，或手动修改 .sublime-theme 文件；前者适合新手，后者适合需精细控制的进阶用户。
直接改 Preferences.sublime-settings 加 background_image 是无效的
Sublime Text 从 4.0 开始，background_image 已被完全移除——它早在 ST3 后期就处于“废弃但未报错”的状态，现在写进去不仅不生效，还可能干扰其他设置加载。网上大量教程仍沿用该字段，导致用户反复尝试失败却找不到原因。
真正起作用的方式只有两种：用支持背景图的第三方主题（如 Material Theme），或手动定制 .sublime-theme 文件。前者省事但功能受限；后者可控性强，是目前唯一稳定、可复现、适配 ST4 的方案。
用主题插件启用背景图（推荐新手）
Material Theme 是目前维护最勤、文档最全、对背景图支持最友好的选择。它不靠 hack 渲染层，而是把背景作为 UI 容器的一部分处理，兼容高 DPI、多显示器和深色/浅色模式切换。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索并安装Material Theme - 安装后，在
Preferences → Themes中选一个带-dark或-light后缀的主题（如Material-Theme-Darker） - 打开
Preferences → Settings – User，添加以下两行（必须同时存在）：{ "theme": "Material-Theme-Darker.sublime-theme", "material_theme_background_panel": true } - 图片路径由插件自动管理，你只需把图放进
Packages/User/backgrounds/（需手动建），然后在设置中加"material_theme_background_image": "backgrounds/your-bg.webp"
注意：material_theme_background_panel 不开启，背景图不会渲染；WebP 格式比 PNG 小 60%+，且 Sublime 对 WebP 解码更稳，别用 JPG（alpha 通道丢失）或大尺寸 PNG（拖慢启动）。
手动改 .sublime-theme 实现精准控制（推荐进阶用户）
如果你需要背景图只出现在编辑区、侧边栏单独调色、或叠加遮罩层，就必须复制并修改主题文件。核心逻辑是：找到 "class": "group" 节点（代表整个编辑窗口画布），注入 layer0.texture 和透明度控制。
- 打开
Preferences → Browse Packages…，进入Packages/目录，新建文件夹如UserTheme - 复制当前所用主题（比如
Default.sublime-theme）到该目录，并重命名为UserTheme.sublime-theme - 编辑该文件，搜索
"class": "group"，在其下添加：{ "class": "group", "layer0.texture": "Packages/UserTheme/bg.webp", "layer0.opacity": 0.12, "content_margin": [0, 0] } - 保存后，在
Settings – User中指定："theme": "UserTheme.sublime-theme"
关键细节：layer0.texture 必须用 Packages/xxx/xxx 这种相对路径（不能用绝对路径或 ./）；opacity 建议设在 0.08–0.15 之间，太高会盖住折叠箭头和行号；content_margin 清零可避免背景图边缘留白。
常见失效原因和验证方法
背景图没显示？90% 是路径、JSON 格式或主题加载顺序问题。别急着重装，先做三件事：
- 检查 Sublime 控制台：
Ctrl+`打开，看是否有Unable to load theme或Invalid JSON报错（缺逗号、多逗号、中文引号都会触发） - 确认图片已放在
Packages/UserTheme/下，且文件名不含空格或特殊符号（如my bg.webp→ 改成bg.webp） - 重启 Sublime —— 主题变更不会热加载，改完不重启等于没改
- 如果界面变白或标签页消失，说明
.sublime-theme语法错误，删掉刚加的 block，用备份文件覆盖即可恢复
真正难的不是加图，而是让图“不抢戏”：背景图永远只是氛围层，文字可读性优先级高于一切。建议先用纯色半透 PNG 做遮罩，再叠纹理图，而不是一张高对比照片直接糊上去。
