sublime text ui主题不能通过preferences.sublime-settings直接修改，必须编辑对应的.sublime-theme文件，按class和layer结构精准覆盖；文件名须严格匹配设置中"theme"值，且需复制到packages/user/下修改，避免插件更新覆盖。
Sublime Text 的 UI 主题不能通过 Preferences.sublime-settings 里的 JSON 配置项直接修改——它压根不认那种写法。真正起效的只有 .sublime-theme 文件，且必须按 class 层级和 layer 结构精准覆盖，否则改了等于没改。
怎么找到并安全覆盖当前生效的 .sublime-theme 文件
主题文件名不是凭空猜的，得看 Settings 右侧用户配置里 "theme" 的值，比如 "theme": "Material-Theme.sublime-theme"。这个字符串就是你要找的文件名，一个字母都不能错。
- 进
Preferences → Browse Packages…，打开User/目录 - 在
Packages/下找到对应主题插件目录（如Material Theme/），复制里面的material-theme.sublime-theme到User/下，并重命名为完全一致的文件名（注意大小写、连字符、空格） - 别直接改原始文件——插件更新时会被覆盖；也别漏掉
.sublime-theme后缀，少一个点都不行
改 quick_panel 字体为什么没反应
命令面板字体由 "class": "quick_panel_label" 这条 rule 控制，但常见失效不是语法错，而是匹配条件没对上。
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- 必须同时满足
class和attributes（比如["selected"]）才生效；想改未选中行，得另加一条不含attributes的同类 rule -
font.face必须是系统已安装字体的**精确名称**，比如"Fira Code"，带空格就得加引号；font.size是数字，不是字符串 - 改完保存后必须重启 Sublime 才能生效——UI: Reload Theme 不管用，这点极容易忽略
侧边栏或标签页颜色调不了？先确认 theme 是否真有定义
像 Adaptive.sublime-theme 这类基础主题本身几乎不定义任何 UI 色彩，只提供结构框架。你改了 sidebar_container 的 layer0.tint，它还是黑的，因为原始文件里压根没这行。
- 搜索
"class": "sidebar_container"，如果找不到，说明当前 theme 没定义侧边栏样式，得换真正带配色的主题（如 Material-Theme、Ayu） -
layer0.tint值是 RGB 数组，比如[199, 237, 204]，不是十六进制；改完部分 UI（尤其是树状目录背景）可能要新开窗口才刷新 - 某些主题依赖
icon_theme或ui_scale等配套设置，单独改.sublime-theme可能视觉错位
为什么改了设置但 UI 完全没变
最常被忽略的是插件劫持：EditorConfig、Theme Toggler、Origami 这类插件会在项目加载时强行重设 theme 或 color_scheme，你的手动配置直接被覆盖。
- 先禁用 EditorConfig：
Tools → EditorConfig → Toggle EditorConfig - 检查是否装了多个主题插件，比如 Material Theme 和 Ayu 同时启用，它们的初始化逻辑会打架
- Sublime Text 4 用户遇到
error parsing theme，基本是用了 ST3 专属主题，得换支持 ST4 的新版
真正难的不是改哪一行，而是搞清 class 怎么嵌套、layer 怎么叠加、哪个 rule 优先级更高——这些没法靠试错，得看原始主题文件的结构逻辑。随便加个 rule 很可能被更上层的规则盖掉，表面没报错，实际无效。
