最稳定的方式是使用自定义 .sublime-theme 文件通过 layer0.texture 设置背景图。需新建主题目录和文件，填入含 texture 路径的 JSON 配置，在用户设置中指定 theme 名，并注意路径正确、图片尺寸适配及格式优选 WebP。
如何在 Sublime Text 中设置自定义背景图片
Sublime Text 本身不提供图形化界面设置背景图，必须通过修改 Preferences.sublime-settings 配置文件手动添加 CSS 样式规则。核心是启用 draw_centered 或 draw_white_space 等无关选项来“释放”画布区域，再用 background 或更可靠的 theme + 自定义 .sublime-theme 实现。
直接改 background 参数为什么经常失效
background 配置项只对编辑区（即文字所在区域）生效，但默认主题下该区域被「透明度叠加」「行号栏遮挡」「折叠图标层叠」等覆盖，导致图片看不见或只显示一角。常见错误现象包括：图片完全不出现、仅左上角显示一小块、滚动时背景撕裂。
- 确保图片路径为绝对路径，且使用正斜杠（Windows 也需写成
C:/Users/xxx/bg.jpg） -
background不支持缩放、平铺控制，图片尺寸不匹配时会拉伸失真 - 部分主题（如 Default Dark）会强制覆盖
background，此时必须改用theme方式
推荐方案：用自定义 .sublime-theme 替换背景（兼容性最好）
这是目前最稳定的方式——复制一份默认主题，注入 layer0.texture 背景图定义，并在用户设置中指定新主题名。Sublime 启动时会优先加载该主题，绕过原主题的样式封锁。
操作步骤：
- 打开
Preferences → Browse Packages…，进入Packages/目录 - 新建文件夹
CustomBgTheme/，在里面创建CustomBgTheme.sublime-theme - 填入如下内容（注意替换
texture路径）：
[
{
"class": "background",
"layer0.texture": "Packages/CustomBgTheme/bg.jpg",
"layer0.opacity": 1.0,
"layer0.tint": [255, 255, 255],
"layer0.inner_stretch": 0
}
]
- 把你的背景图（建议 PNG，带 alpha 通道更好）放入同一目录，命名为
bg.jpg或对应名称 - 在
Preferences.sublime-settings（用户）中添加："theme": "CustomBgTheme.sublime-theme"
容易被忽略的细节和性能影响
高分辨率背景图（如 4K）会导致 Sublime 启动变慢、滚动卡顿，尤其在旧硬件或开启 GPU 渲染时。Sublime 不做图片解码缓存，每次重绘都重新加载纹理。
- 图片尺寸建议控制在 1920×1080 以内，格式优先选 WebP（比 PNG 小 60%+）
- 避免使用
layer0.offset或layer0.scale动态调整，它们在不同 DPI 屏幕上表现不一致 - 如果启用了
font_options: ["gray_antialias"]，背景图可能显得发灰，可尝试关掉或改用subpixel_antialias
真正起作用的永远是 theme 文件里的 layer0.texture 路径是否可读、是否被其他 layer 覆盖、以及当前 color scheme 是否透出底层。调错一次，往往是因为路径多了一个空格，或者主题名拼写大小写不一致。
