sublime text 自定义皮肤本质是编辑 .sublime-color-scheme 文件，需包含 name、author、globals 和 rules 四个顶层字段，其中 globals 控制 ui 元素颜色，rules 控制语法高亮，且必须放在 packages/user/ 目录下才能生效。
Sublime Text 自定义皮肤本质是修改 .sublime-color-scheme 文件
Sublime Text 3.0+ 的“皮肤”不再叫 theme（.tmTheme），而是 color scheme（.sublime-color-scheme），它是一个 JSON 格式的配色定义文件，控制语法高亮、UI 元素（如侧边栏、标签页、状态栏）的背景/文字/边框颜色。你不能用 Python 或 JavaScript “编写”皮肤逻辑，但可以手动编辑或生成符合规范的 .sublime-color-scheme 文件。
常见错误现象：Package Control 安装的 “Theme” 实际是 UI 主题（.sublime-theme），和代码配色无关；把旧版 .tmTheme 直接改后缀名扔进 Packages/User/ 会导致不生效或报错。
- 真正生效的自定义皮肤必须放在
Packages/User/目录下，文件名以.sublime-color-scheme结尾 - 必须包含
name、author、variables（可选）、globals和rules四个顶层字段 -
globals控制 UI 元素（如background、foreground、selection），rules控制语法高亮（如comment、string、keyword）
从现有方案快速生成可用的 .sublime-color-scheme
手动写全量 JSON 容易出错，推荐用 scopehunter 插件 + 官方 Color Scheme Editor（或第三方工具如 sublimescheme CLI）辅助。最直接的实操路径是：先复制一个已知能用的 scheme（比如默认的 Monokai.sublime-color-scheme），再局部修改。
使用场景：你想微调当前主题的注释颜色，或让行号变浅一点，不需要重写全部规则。
- 在 Sublime 中按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Developer: Show Scope Name，把光标停在某段代码上，就能看到它实际匹配的 scope（如comment.line.number-sign.python） - 打开
Packages/Color Scheme - Default/Monokai.sublime-color-scheme，复制整个内容到新文件，保存为Packages/User/MyCustom.sublime-color-scheme - 修改
globals.foreground改全局文字色，或在rules数组里加一条{"scope": "comment", "foreground": "#6a9955"}
rules 里的 scope 匹配不是正则，而是层级继承关系
很多人以为写 "scope": "string" 就能匹配所有字符串，结果发现双引号字符串变了色，但 f-string 或三引号没反应——这是因为 scope 是树状结构，string.quoted.double.python 继承自 string，但 string.interpolated.python 不一定。
性能影响：规则越多、scope 字符串越长，渲染时匹配开销略增，但日常几十条无感；兼容性上，不同语法包（如 Python vs Enhanced Python）定义的 scope 可能不同。
- 优先用宽泛 scope（如
comment、keyword），再按需细化（如keyword.control.conditional.python） - 避免重复覆盖：同级 scope 中后写的规则会覆盖前面的，但子 scope 优先级更高
- 调试技巧：临时加一条
{"scope": "*", "foreground": "#f00"}看是否全局生效，确认文件加载无误
UI 元素颜色（globals）和语法高亮（rules）必须分开配置
有人试图在 rules 里写 "scope": "region.yellowish" 去改侧边栏颜色，结果无效——region.* 是用于标记（如 Bookmarks、Find Highlight），不是 UI 控件。真正的 UI 颜色由 globals 下的固定 key 控制，比如 gutter（行号区）、line_highlight（当前行底色）、tab_active_background（活动标签页背景）。
容易踩的坑：gutter 默认透明，如果设了纯黑但没同步改 gutter_foreground，行号就看不见；selection 和 selection_border 不配对设置，会导致选区边缘发虚或溢出。
- 必须存在的
globals字段：至少包含background、foreground、selection，否则 Sublime 拒绝加载 -
tab_active_background接受 CSS 风格的rgba(0, 0, 0, 0.1)，但不支持hsl()或变量引用（除非你定义了variables并用var(…)引用） - 改完保存后，无需重启 Sublime，但要执行
Preferences → Color Scheme → User/MyCustom才生效
真正麻烦的不是写 JSON，而是搞清 scope 层级和 globals key 名称——它们没有完整文档，得靠 Scope Hunter 实时查、靠试错验证。改一个颜色前，先确认它是属于语法（rules）还是 UI（globals），再找对 scope 或 key，比盲目堆规则有用得多。
