Sublime Text无法一键同步GitHub配置，必须用Git管理Packages/User目录。退出程序后，在User目录执行git init、add三类文件（.sublime-settings/.keymap/.snippet）、commit并推送到GitHub；新设备需克隆仓库后创建符号链接，再通过控制台脚本同步插件列表。

Sublime Text 没有“一键同步 GitHub 配置”的功能——所有声称能自动同步 Preferences.sublime-settings 或 .sublime-snippet 到 GitHub 的插件（如 GistSync、SyncSettings）均已停更，且无法适配当前 GitHub API 和 .sublime-snippet 的 XML 格式校验规则，强行启用会导致片段加载失败、tabTrigger 失效或快捷键冲突。 真正可行的同步方式，是把 Packages/User/ 目录作为普通代码项目来管理。下面直说关键操作点。

为什么不能用 Gist 或自动同步插件

GitHub Gist 不是 Git 仓库，不支持分支、commit 历史、冲突提示；第三方插件依赖已下线的 GitHub v3 API，且无法处理：
• .sublime-snippet 中 <scope> 或 <tabTrigger> 的大小写/空格敏感问题
• Windows（CRLF）与 macOS/Linux（LF）换行符差异导致 XML 解析失败
• Package Control.sublime-settings 含插件安装时间戳和本地路径，上传到公开 Gist 有隐私泄露风险
• 插件在后台写入文件时，Gist 同步插件可能读取到半截内容，造成损坏

用 Git 管理 Packages/User/ 的实操步骤

这是目前唯一稳定、可回溯、跨平台兼容的方式：

• 退出 Sublime Text（避免文件被锁）
• 执行 Preferences → Browse Packages…，进入 Packages/ 目录，再进 User/
• 在该目录下运行：
  git init
git add *.sublime-settings *.sublime-keymap *.sublime-snippet
git commit -m "initial config"
• 添加远程仓库：
  git remote add origin https://github.com/yourname/sublime-user.git
• 推送：
  git push -u origin main

注意：git add 不要加 .——会误纳入缓存文件（如 Local History 目录），应在 .gitignore 中明确排除：
*.pyc
Local History/
Session.sublime-session
Backup*.sublime-settings

多设备拉取配置时的关键动作

在新机器上不是“复制粘贴”，而是“克隆 + 符号链接”：

Git Changelog Generator

使用约定式提交（Conventional Commits）从 Git 历史记录中生成结构化变更日志，支持多种格式、AI 增强型描述以及可自定义的范围……

下载

• 先关闭 Sublime Text
• 备份原 Packages/User/（重命名为 User.bak）
• 执行：
  git clone https://github.com/yourname/sublime-user.git ~/sublime-user
• 创建符号链接（路径需按系统调整）：
  macOS/Linux：ln -sf ~/sublime-user ~/Library/Application\ Support/Sublime\ Text/Packages/User
  Windows：mklink /J "%APPDATA%\Sublime Text\Packages\User" "C:\path\to\sublime-user"

符号链接必须指向克隆出的干净目录，不能直接在原 User/ 内运行 git pull——Sublime 可能在后台写入临时文件，引发 Git 冲突或覆盖。

插件列表怎么同步

Package Control 本身不保存已装插件列表，但可导出/还原：

• 打开 Sublime 控制台（Ctrl+`），执行：
  import json; print(json.dumps(sorted([x for x in set(sublime.installed_packages()) if not x.startswith('.')]), indent=2))
• 把输出保存为 installed_packages.json，加入 Git 仓库
• 新设备装好 Package Control 后，在控制台运行：
  import json, sublime; pkgs = json.loads(open(sublime.packages_path() + '/../User/installed_packages.json').read()); [sublime.run_command('package_control_install_package', {'package': p}) for p in pkgs]

这个过程无法“一键”，但比手动一个个装快得多；注意 Package Control 必须先装好，否则 package_control_install_package 命令不存在。

Git 管理 User/ 目录看似多几步，但换来的是每次修改都有记录、不同设备编辑冲突能被 Git 明确提示、换行符和 XML 结构错误在提交前就能发现——这些恰恰是 Gist 同步永远做不到的底层保障。