Sublime Text语法绑定不会自动同步，因仅Packages/User/下的.sublime-syntax文件才被识别，且需满足文件名合法、scope唯一、无绝对路径引用等条件；必须将其放入User/并同步整个目录，同时清理缓存、确保插件已安装，才能跨设备生效。
语法绑定（即 .sublime-syntax 文件）不属于“个人配置同步”的常规范围，它默认不随 Packages/User 同步，也不能直接用符号链接自动生效——除非你明确把它放进 User 目录并手动注册。
为什么语法绑定不会被自动同步
Sublime Text 加载语法文件的顺序是：Packages/ → Installed Packages/ → Packages/User/。但只有放在 Packages/User/ 下的 .sublime-syntax 才算“用户级语法”，且必须满足两个条件才能被识别：
- 文件名不能含空格或非法字符（如
My Custom Syntax.sublime-syntax会静默失败，应改为MyCustomSyntax.sublime-syntax） - 文件头部必须包含合法的
scope声明，且不能与系统已有语法 scope 冲突（例如重复定义source.python） - 若语法依赖其他文件（如
.sublime-snippet或嵌套 include），这些文件也得一并放进User/，否则加载时无报错但高亮失效
如何让自定义语法在多台设备上一致生效
最稳妥的方式是：把语法文件和配套资源统一放 Packages/User/，再通过符号链接同步整个 User/ 目录——这是唯一能保证语法、快捷键、设置、片段四者行为完全一致的路径。
- 确认语法文件已放入
Packages/User/MyCustomSyntax.sublime-syntax（不是Packages/MyCustomSyntax/） - 检查该文件是否在
Preferences → Settings – Syntax Specific中可选；若不可见，用Ctrl+Shift+P输入Set Syntax: MyCustomSyntax尝试手动触发，失败则说明 scope 或文件结构有误 - 如果语法依赖插件（如
YAML解析器用于自定义配置语法），确保对应插件也出现在Package Control.sublime-settings的installed_packages列表中，并在各设备上重装一次 - macOS/Linux 用户注意：云盘同步后，
.sublime-syntax文件权限可能变为只读，需运行chmod 644 ~/Dropbox/SublimeConfig/User/*.sublime-syntax
迁移时最容易忽略的三个点
语法绑定同步失败，90% 源于以下三处未校验：
-
Packages/User/下存在同名但内容不同的.sublime-syntax（比如一台是 LF 换行，另一台是 CRLF，XML 解析器会跳过整段） - 语法文件里用了绝对路径引用外部规则（如
include: Packages/SomePlugin/some-rule.yaml），而该插件在目标设备未安装或路径不同 - 没删掉旧设备残留的缓存：关闭 Sublime 后，手动删除
Packages/User/.sublime-syntax.cache（如有）和Cache/目录下相关条目，否则新语法可能被缓存覆盖
真正跨设备生效的语法绑定，从来不是“复制过去就行”，而是“放进 User/ + 被正确引用 + 缓存清干净”。少做一步，就只能看到文件在目录里，却看不到高亮。
