sublime text 4仅支持.sublime-color-scheme格式主题，.tmtheme不兼容；确认路径正确、大小写一致、json无语法错误，并通过developer: show scope name验证scope匹配，优先使用custom.sublime-color-scheme定制。
Sublime Text 4 只认 .sublime-color-scheme 文件，老的 .tmTheme 直接扔进去不会显示、不报错、也不加载——这是你找不到新主题的第一原因。
怎么确认当前用的是 .sublime-color-scheme 格式
打开 Preferences → Color Scheme，下拉列表里看到的方案名，基本都来自 .sublime-color-scheme 文件。如果某个你刚放进去的主题没出现，大概率是格式不对或路径错了。
- 右键已启用的主题 → “Copy Path”，粘贴出来看后缀是不是
.sublime-color-scheme - 路径里含空格（比如
Color Scheme - Default）必须保留，大小写也必须一致 - 用命令面板
Ctrl+Shift+P→ 输入Developer: Show Scope Name，能正常弹出 scope 说明语法和配色加载链是通的；如果连 scope 都不显示，说明当前文件根本没绑定有效语法，配色自然无效
Custom.sublime-color-scheme 是唯一安全的自定义入口
别直接改原始主题文件。Sublime 官方推荐且唯一支持热重载的用户级覆盖方式，是使用 Preferences → Customize Color Scheme 自动创建的 Custom.sublime-color-scheme。
- 它默认存放在
Packages/User/Custom.sublime-color-scheme，结构是 JSON patch 形式：只写你想改的部分，比如只加一条"selection"规则，其余继承原主题 - 文件里不能缺
"variables"或"globals"字段——但Custom.sublime-color-scheme不需要你手动写这些，它自动合并上游 - 写错 JSON 格式（比如多逗号、少引号、用了中文标点）会导致整个文件静默失效，编辑区回退到默认 Monokai，且 Sublime 不提示
rules 里 scope 写错就等于没写
rules 数组控制语法高亮，但每条规则的 scope 必须精准匹配当前光标位置的真实 scope 链，否则这条规则完全不生效。
- 不要靠猜：打开代码文件 → 光标停在字符串上 →
Ctrl+Shift+P→Developer: Show Scope Name→ 看输出，比如source.python string.quoted.double - 写
"scope": "string"很可能没用，得写"scope": "string.quoted.double"或更宽泛的"scope": "string"（取决于主题是否在更上层定义了 fallback） - 多个 scope 可用空格分隔：
"scope": "comment line"，表示同时匹配 comment 和 line 两个 scope - scope 名里带点（
.）不是层级分隔符，而是完整命名的一部分，不能拆开或省略
项目级和语法级 color_scheme 设置会覆盖全局
你以为改了用户设置里的 "color_scheme" 就万事大吉？实际优先级是：语法专属设置 > 项目设置 > 用户设置 > 默认设置。
- 检查右下角语法名（如 Python），点它 →
Open Syntax Specific Preferences，看里面有没有"color_scheme"字段 - 打开项目文件
.sublime-project，确认"settings"下有"color_scheme": "Packages/.../xxx.sublime-color-scheme"，路径必须以Packages/开头，不能是相对路径或绝对路径 - 改完项目或语法设置后，必须关闭再重新打开文件/项目，热保存不触发重载
- 插件（如 MarkdownEditing）自带的语法定义会覆盖默认路径，此时改
Packages/Markdown/Markdown.sublime-syntax没用，得去插件解压后的实际路径改
真正难的从来不是改哪一行，而是搞清当前生效的到底是哪个文件、哪个字段、哪个 scope——Sublime 不报错，只沉默跳过，所有“没反应”背后，都是某一层配置被更高优先级覆盖或某处路径/JSON/大小写出了毫厘之差。
