st4仅识别.sublime-color-scheme（json格式），st3仅识别.tmtheme（xml格式）；文件须置于packages/user目录、命名规范、路径准确、配置项color_scheme指向正确，且json语法无误。
配色文件格式必须匹配 Sublime 版本
ST4 只认 .sublime-color-scheme（JSON 格式），ST3 只认 .tmTheme（XML 格式）。把 ST3 的 Monokai.tmTheme 直接丢进 ST4 的 Packages/User 目录，它根本不会出现在 Color Scheme 列表里——连错误提示都不会有，就是“看不见”。
- 查版本：菜单 Help → About Sublime Text，看开头是 “Sublime Text 4” 还是 “Sublime Text 3”
- ST4 用户必须找后缀为
.sublime-color-scheme的文件；若只有.tmTheme，得用在线转换工具（如 tmTheme-to-sublime-color-scheme）转成 JSON - 文件名里不能有空格或中文，建议全小写+下划线，例如
my_dark.sublime-color-scheme
文件必须放在正确路径才能被识别
Sublime 只扫描固定几个目录加载配色方案，放错位置等于没放。最稳妥的路径是 Packages/User，其次是插件专属目录（如 Packages/Material Theme/schemes/），但后者要求插件本身声明了该路径。
- 打开菜单 Preferences → Browse Packages → 进入弹出的文件夹，直接打开
User子目录 - 把下载好的
.sublime-color-scheme文件拖进去，不要嵌套子文件夹 - 别放进
Installed Packages或根目录下的Packages（那是只读缓存区） - 重启 Sublime 不是必须的，但改完后务必在 Preferences → Color Scheme 里刷新列表，新名字应该立刻出现
启用后不生效？检查 color_scheme 配置项
手动安装只是第一步，真正启用还得靠配置。如果菜单里选了新主题但编辑区颜色没变，大概率是用户设置里硬编码了别的配色路径，把它覆盖了。
- 打开 Preferences → Settings，右侧用户配置里搜
"color_scheme" - 如果存在这一行，确认它的值指向你刚放进去的文件，格式必须是：
"Packages/User/my_dark.sublime-color-scheme" - 路径大小写敏感，
User不能写成user，扩展名不能漏掉 - 如果没这行，删掉它——让 Sublime 用菜单选择的结果，反而更可靠
自定义配色改完保存却没反应
编辑 .sublime-color-scheme 文件后保存，Sublime 理论上会自动重载，但有时会卡住。常见原因是 JSON 格式错误，比如多了一个逗号、少了一个引号，或者用了注释（JSON 不支持 // 或 /* */）。
- 用 VS Code 或 Sublime 自己打开该文件，它会高亮语法错误；也可以粘贴到 jsonlint.com 验证
- 改完保存后，按
Ctrl+Shift+P输入Color Scheme:，再选一次你的主题，强制刷新 - 如果背景变白或全黑，大概率是
"background"或"foreground"值写成了无效十六进制（比如#ggg或漏掉#）
真正麻烦的不是放文件，而是路径、格式、配置三者咬合不上。哪怕只错一个字符，Sublime 就静默失败——它不会报错，只会假装没看见。
