syncsettings 插件已失效，因其依赖的 github v3 api 下线、硬编码凭证废弃，且存在文件名校验、换行冲突等问题；推荐仅同步 packages/user/ 目录，用 git 管理并跨平台分存 keymap 文件。
SyncSettings 插件早已失效，不能通过 GitHub 一键同步 Sublime Text 配置。它依赖的 GitHub v3 API 已下线，且不再维护，强行安装会导致 Preferences.sublime-settings 加载失败、.sublime-snippet 文件无法识别、快捷键失灵等静默错误。
SyncSettings 为什么装了也白装
- 官方仓库（kemayo/sublime-text-syncsettings）自 2019 年起无更新，最后一次兼容版本止于 Sublime Text 3.2
- 它调用的
@#@#@#@#@#@#@#@#@#@0接口要求 OAuth token，但插件内硬编码的 client_id/client_secret 已被 GitHub 废弃 - 即使手动填入个人 token，也会因 Gist 文件名校验（如必须以
.sublime-settings结尾）、XML scope 格式不匹配、CRLF/LF 换行冲突等问题导致片段加载失败 - 插件会覆盖你本地的
Package Control.sublime-settings，里面含已安装插件列表，一旦出错，所有插件需重装
替代方案：只同步 Packages/User/ 目录，不碰插件本身
Sublime Text 的配置本质是纯文本文件，真正需要同步的只有：
Preferences.sublime-settings-
Default (Windows).sublime-keymap（或对应平台的 keymap） - 所有
*.sublime-snippet - 各插件在
User/下的配置文件（如SideBarEnhancements.sublime-settings）
Package Control 本身能根据 Package Control.sublime-settings 中的 installed_packages 列表自动重装插件，无需同步整个 Installed Packages/ 或 Packages/ 目录。
实操：用 Git 同步 User/ 目录（推荐）
- 关闭 Sublime Text（避免文件被锁）
- 进入
Packages/User/目录（Preferences → Browse Packages… 最可靠） - 执行以下命令（路径替换成你自己的）：
git init git add *.sublime-settings *.sublime-keymap *.sublime-snippet git commit -m "initial config" git remote add origin https://github.com/you/sublime-user.git git push -u origin main
- 在新电脑上克隆后，用符号链接指向该目录（不是复制）：
- Windows：
mklink /D "%APPDATA%\Sublime Text 3\User" "D:\path\to\cloned\User"（需管理员权限） - macOS/Linux：
ln -s ~/path/to/cloned/User ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/User
- Windows：
注意：不要把 Package Control.sublime-settings 提交到公开仓库——里面明文记录了你装过的所有插件名，可能暴露技术栈。
最容易被忽略的一点
跨平台同步时，.sublime-keymap 文件必须按平台分文件存放（Default (Windows).sublime-keymap、Default (OSX).sublime-keymap、Default (Linux).sublime-keymap），不能混用一个文件。否则 Windows 上按 Ctrl+Shift+P，macOS 用户会发现对应快捷键根本不存在。
