语法绑定文件必须放在packages/user/下才生效，sublime text仅扫描该目录及其子目录中的.sublime-syntax文件，路径错误、后缀不符、大小写混淆或嵌套过深均导致静默失效。
语法绑定文件必须放在 Packages/User/ 下才生效
Sublime Text 只扫描 Packages/User/ 目录及其子目录里的 .sublime-syntax 文件，其他位置（比如桌面、Packages/MyPlugin/ 或 Data/Packages/ 里非 User 路径）一概不加载。手写或拖进去的文件如果路径不对，编辑器完全无视，也不会报错——静默失效是常态。
常见错误包括：
• 把 myconfig.sublime-syntax 放在 Packages/User/myconfig/ 的子文件夹里，但嵌套超过一层（如 Packages/User/myconfig/v1/）就不识别
• 文件名写成 myconfig.syntax 或 myconfig.sublime-syntax.bak，后缀必须严格为 .sublime-syntax
• 大小写混淆，MyConfig.sublime-syntax 和 myconfig.sublime-syntax 在 macOS/Linux 上是两个不同文件
备份前必须确认文件真实路径和内容合法性
别靠记忆或拼路径。最准的方法是：启动 Sublime → Preferences → Browse Packages…，弹出窗口地址就是你要操作的真实根路径；再手动进入 User/ 子目录，确认你的语法文件确实在里面。
文件内容也得过三关：
• 必须用 Tools → Developer → New Syntax 创建模板再改，手写容易漏 main context 或缩进错位
• file_extensions 必须是 YAML 列表格式，例如：- cfg、- env，不能写成 "cfg" 或 ["cfg"]
• scope 字段必须以 source. 开头（如 source.myconfig），写成 text.myconfig 或纯 myconfig 都无效
只备份 .sublime-syntax 文件还不够，还得同步配色映射
语法文件只负责“打标签”，比如把 if 标为 keyword.control.myconfig；最终颜色由当前 color_scheme 决定。如果你用了自定义主题（如 Dracula、Monokai Extended），而该主题没定义 keyword.control.myconfig 的样式，那再准的语法也没颜色。
所以迁移时要一起带上的有：
• Packages/User/xxx.sublime-syntax 文件本身
• 状态栏右下角点击语法名 → Color Scheme → Save Current Color Scheme 导出的 .sublime-color-scheme 文件（或对应 .tmTheme）
• 若主题来自插件（如 Packages/Dracula Color Scheme/），还得把整个插件目录一并备份，否则 color_scheme 字段引用会失败
调试时用 Show Scope Name 验证是否真被识别
按 Ctrl+Shift+P 输入 Show Scope Name，把光标停在目标词上，看弹出的作用域是不是你语法里写的那个（比如 keyword.control.myconfig）。不是？说明语法文件压根没加载，或 match 规则顺序/正则写错了。
容易忽略的点：
• contexts 里规则从上到下匹配，一旦前面某条 match 吃掉了整行（比如注释规则没加 $ 锚定结尾），后面的关键字规则就永远不触发
• 用了 push: 进入新 context 却忘了配 pop: true，后续所有文本都卡在那个 context，全变成同一种颜色
• 文件保存后没重启 Sublime，或没重新打开对应后缀的文件——语法绑定不会热重载
