sublime text 自定义主题需创建同名文件夹和 .sublime-theme 文件并置于 packages 目录；最小主题示例仅修改 sidebar_container 的 texture 和 opacity；须注意路径有效性、class 名称大小写，并通过“ui: reload theme”命令实时调试。
Sublime Text 的 UI 主题（Theme）是通过 .sublime-theme 文件定义的 JSON 格式资源，控制界面元素的外观（如侧边栏、标签页、状态栏等）。从零开始创建一个自定义主题，核心是理解其结构、掌握关键字段，并用 Sublime 自带的调试能力快速验证效果。
准备基础文件结构
一个最简主题至少包含一个 .sublime-theme 文件，放在正确路径下才能被识别：
- 新建文件夹，例如
MyCustomTheme - 在该文件夹中创建
MyCustomTheme.sublime-theme（文件名需与文件夹名一致） - 将整个文件夹放入
Packages/目录：
Windows:%APPDATA%\Sublime Text\Packages\
macOS:~/Library/Application Support/Sublime Text/Packages/
Linux:~/.config/sublime-text/Packages/
写一个最小可运行的主题文件
打开 MyCustomTheme.sublime-theme，填入以下内容：
[
{
"class": "sidebar_container",
"layer0.texture": "Theme - Default/textures/sidebar.png",
"layer0.opacity": 1.0
}
]这是合法的 theme 文件：它只修改了侧边栏容器的背景贴图和不透明度。保存后，在 Preferences → Theme 中选择 MyCustomTheme 即可生效。注意：layer0.texture 路径必须指向实际存在的图片（推荐先复用默认主题里的资源路径），否则会回退为纯色。
理解核心语法与常用 class
每个主题规则是一个对象，必须含 "class" 字段，表示要样式化的 UI 元素。常见 class 包括：
-
sidebar_container：侧边栏整体容器 -
tabset_control：标签页区域（含所有标签+新建按钮） -
tab_control：单个标签页（未激活状态） -
tab_close_button：标签右上角关闭按钮 -
status_bar：底部状态栏 -
overlay_control：命令面板、Goto Anything 等弹出层
支持的样式属性包括：layer0.texture、layer0.tint、layer0.opacity、content_margin、padding、font.size、color（部分控件）等。注意：不是所有 CSS 属性都可用，theme 是 Sublime 特有的渲染层描述语言。
调试与实时预览技巧
Sublime 不支持热重载 theme，但有高效调试方式：
- 修改 theme 文件后，按 Ctrl+Shift+P（Cmd+Shift+P）→ “UI: Reload Theme”** 立即应用（无需重启）
- 启用开发者模式：Ctrl+` 打开控制台，输入
sublime.log_commands(True)，再点击 UI 元素，可看到其 class 名称输出 - 参考官方默认主题源码：
Packages/Theme - Default/Default.sublime-theme，它是最佳学习样本 - 用
"debug": true字段临时加在某条规则里，可在控制台看到该 rule 是否被匹配到
基本上就这些。不复杂但容易忽略的是路径正确性和 class 名称大小写——Sublime 对二者都敏感。从改一个小元素（比如让标签页变圆角或换底色）开始，逐步叠加，比一上来写满屏规则更稳妥。
