Sublime的.sublime-snippet文件必须手动管理路径、格式和scope，Gist同步不可靠；唯一稳定方案是用Git管理Packages/User/目录，并严格遵循命名、XML结构、scope和CDATA顶格等规则。
不能靠 Gist 自动同步，也别信“一键备份”插件——Sublime 的 .sublime-snippet 文件必须手动管理路径、格式和 scope，否则换电脑后大概率失效。
为什么 Gist 同步在 Sublime 里基本不可用
所有标榜“Gist 同步 Preferences.sublime-settings 或 .sublime-snippet”的第三方插件（如 GistSync、SyncSettings）均已停更，且依赖已下线的 GitHub v3 API；它们无法处理 .sublime-snippet 的 XML 格式校验、scope 冲突、CRLF/LF 换行差异，一同步就导致片段加载失败或 tabTrigger 失灵。你看到的“成功提交”，只是把 XML 当普通文本扔上去了，Sublime 根本不认。
- GitHub Gist 不提供文件系统级权限，Sublime 无法自动读写本地
Packages/User/目录 - 没有加密、增量 diff、冲突合并机制，两个设备同时改了同一个
log-js.sublime-snippet，Gist 会静默覆盖，不提示 - 手动复制粘贴 Gist 内容恢复？那不是同步，是单次备份——每改一个 snippet 都得重来一遍，
tabTrigger和scope错一个字符就白干
真正能跨电脑复用的备份法：只管 Packages/User/ 目录
Sublime 只加载 Packages/User/ 下的 .sublime-snippet 文件，其他位置（桌面、项目根目录、Packages/MyPlugin/）全无效。Git 是唯一稳定方案，它解决的是 Gist 根本不碰的问题：版本回退、并发修改提示、换行符统一、忽略缓存。
- 退出 Sublime Text（避免文件被锁）
- 用
Preferences → Browse Packages…打开目录，进入User/子目录 - 运行：
git init<br>git add *.sublime-snippet *.sublime-settings *.sublime-keymap<br>git commit -m "snippets and settings"
- 添加远程仓库：
git remote add origin https://github.com/you/sublime-user.git - 推送到 GitHub/GitLab/Gitee：
git push -u origin main - 新机器上克隆后，用符号链接指向该
User/目录（Windows 用mklink /D，macOS/Linux 用ln -s）
新建或修改 snippet 时最容易踩的四个坑
Sublime 对 snippet 文件极其敏感，错一个环节就静默失效——不报错、不提示、不加载。
-
file name必须是英文小写 + 连字符 +.sublime-snippet（如log-js.sublime-snippet）；log.snippet、log.js、log-console.sublime-snippet.txt（Windows 隐藏扩展名常见）全被忽略 -
<content></content>里的代码必须用顶格包裹，不能缩进，不能换行；写成<content></content>会导致插入时多出空行和缩进 -
<scope></scope>必须精确匹配当前语法，比如 Vue 单文件组件的<script></script>块真实 scope 是source.vue meta.script.js，不是source.js；查法：打开目标文件 →Ctrl+Shift+P→ 输入View Package File→ 看状态栏显示 - 多个 snippet 设了相同
<tabtrigger></tabtrigger>（如都设为log），Sublime 静默采用「最后修改时间最新」的那个——你以为改了 A，实际触发的是 B，排查要搜整个User/目录里所有含<tabtrigger>log</tabtrigger>的文件
最麻烦的不是备份，是确保每个 .sublime-snippet 在新环境里真能触发：路径对、后缀对、XML 结构对、scope 对、CDATA 顶格对——少一个，它就安静地躺在那里，像没写过一样。
