Sublime Text 主题需区分 .sublime-color-scheme（管语法高亮与编辑区样式）和 .sublime-theme（管 UI 元素结构与外观），二者分工明确、可独立切换，修改前须确认当前使用类型，避免无效操作。
Sublime Text 主题不能靠“改颜色”蒙混过关，必须理解 .sublime-color-scheme 和 .sublime-theme 的分工——前者管语法高亮和编辑区样式，后者管 UI 元素（标签页、侧边栏、状态栏等）的结构与外观。直接编辑错误的文件，改半天也不会生效。
怎么确认当前用的是 color scheme 还是 theme？
打开 Preferences → Color Scheme，看到路径含 .sublime-color-scheme（如 Monokai.sublime-color-scheme）就是配色方案；Preferences → Theme 里选的是 .sublime-theme 文件（如 Adaptive.sublime-theme）。两者可独立切换，但常被误以为是一回事。
- 修改语法高亮（比如让
string变成橙色、comment变半透明）→ 编辑.sublime-color-scheme - 想加圆角标签页、隐藏侧边栏滚动条、调整状态栏高度 → 编辑
.sublime-theme - 主题包（如 Ayu、Dracula）通常同时提供两个文件，缺一不可
修改 .sublime-color-scheme 时最常踩的坑
它本质是 JSON，但不是任意加字段就能生效：Sublime 只识别预定义的 scope 名称（如 keyword、entity.name.function），拼错或乱套继承关系，样式就失效。
- 别手写 scope 名——用
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）调出命令面板，运行Developer: Show Scope Name，把光标停在目标代码上，实时看准确 scope - 修改前先复制原文件，重命名（如
MyMonokai.sublime-color-scheme），再在Preferences → Color Scheme里手动选中它，避免覆盖官方文件 - 颜色值必须用十六进制（
"#FF6B6B"）或 rgba（"rgba(255, 107, 107, 0.8)"），不支持hsl()或英文色名 - 若改完没反应，检查 JSON 格式是否合法（逗号结尾、引号闭合），Sublime 不报错，只静默忽略整段
自定义 .sublime-theme 要绕开的结构陷阱
.sublime-theme 是 JSON 数组，每项是一个 UI 元素规则（如 "class": "tabset_control"），匹配成功才应用 "layer0.tint" 等属性。但 Sublime 的 UI 类名不公开文档，全靠反推。
- 优先用 PackageResourceViewer 插件提取默认主题源码（如
Theme - Default/Default.sublime-theme），比网上搜到的二手片段更可靠 - 不要试图全局改
"layer0.opacity"——这会让所有控件变透明，包括你不想动的按钮；应精准定位 class，例如只改标签页："class": "tab_control" - 圆角、阴影等依赖
"layer0.texture"（图片资源）或"layer0.inner_margin"配合"content_margin"，纯靠"corner_radius"在某些元素上无效 - macOS 下状态栏高度由
"status_bar"class 控制，但 Windows/Linux 需额外处理"status_bar_control"，跨平台主题要分条件写
真正卡住人的往往不是语法，而是 Sublime 的“延迟加载”机制：改完 .sublime-theme 后，必须重启 Sublime 或执行 UI: Reload Theme 命令（需安装 ApplySyntax 或 ThemeSync 等插件支持），否则连最简单的背景色变化都看不到。
