只同步 User 文件夹是最可靠方式，因其仅含纯文本配置文件（.sublime-settings等），而插件由Package Control自动安装；同步整个Packages会导致跨平台兼容问题、API不兼容及崩溃。

git 同步 Sublime Text 配置是目前最可靠、可追溯、跨平台兼容性最好的方式，前提是只同步 User 文件夹，不要同步整个 Packages 或 Installed Packages 目录——后者会因系统/架构差异导致插件加载失败。

---

为什么只同步 User 文件夹？

Sublime Text 的个性化配置（快捷键、主题、设置、代码片段、插件启用状态）全存在 User 目录下，而插件本体由 Package Control 自动下载安装。同步整个 Packages 会导致：

• Windows 编译的插件在 macOS/Linux 上无法加载（比如含 .pyd 或 .so 的插件）
• Package Control.sublime-package 被覆盖后可能失效
• 不同版本 Sublime Text 对插件 API 兼容性不一致，引发崩溃

正确做法：只让 git 管理 User 下的 .sublime-settings、.sublime-keymap、.sublime-snippet 等纯文本文件。

---

初始化本地 User 仓库的实操步骤

先确认路径（别错进 Installed Packages）：

• Windows：%APPDATA%\Sublime Text 3\Packages\User
• macOS：~/Library/Application Support/Sublime Text 3/Packages/User
• Linux：~/.config/sublime-text-3/Packages/User

进入该目录后执行：

git init
git add .
git commit -m "Initial config: keymaps, settings, snippets"

注意过滤非必要文件，建议在根目录加 .gitignore：

Cache/
Session.sublime_session
Local History/
*.log

然后关联远程仓库（GitHub 私有库更安全）：

github-repo-analyzer

当用户提及 GitHub URL，或要求分析、审查、探索或理解任意 GitHub 项目、仓库或代码库时，请使用此技能。触发条件包括以下短语：“分析这个项目”、“看看这个仓库”、“analyze this repo”、“what does this project do”，或消息中包含任何 github.com URL。

下载

git remote add origin https://github.com/yourname/sublime-user.git
git branch -M main
git push -u origin main

---

在新电脑上克隆并生效的关键动作

必须严格按顺序操作，否则 Sublime Text 会覆盖或忽略你的配置：

• 关闭 Sublime Text（后台进程也要杀掉，macOS 尤其容易残留）
• 备份原 User 文件夹：mv User User.bak
• 克隆到原位置：git clone https://github.com/yourname/sublime-user.git User
• 重新打开 Sublime Text —— 此时所有 .sublime-settings 已加载，但插件还没装

接下来手动触发插件重装：

• 按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P）
• 输入 Package Control: Satisfy Dependencies 并运行（它会读取 Package Control.sublime-settings 中记录的已启用插件列表，并自动安装缺失项）

如果某些插件仍没出现，再运行 Package Control: Install Package 手动补装一次。

---

日常同步与容易踩的坑

日常只需在 User 目录下执行：

git pull
# 修改配置后
git add .
git commit -m "Update color_scheme and tab_size"
git push

但要注意这些实际问题：

• 不同系统下 Preferences.sublime-settings 可能需要差异化，比如 font_face 在 Windows/macOS/Linux 名字不同，可用 platforms 键做条件配置
• 某些插件（如 SideBarEnhancements）会在 User 下生成缓存文件（如 SideBarEnhancements.json），它们不该进 Git，要写进 .gitignore
• 用 GitHub Desktop 或 VS Code 拉取时，确保工作区编码为 UTF-8，否则中文注释可能乱码
• 别在两台电脑上同时改同一个 .sublime-settings 再推送，Git 冲突需手动解决，Sublime 不会帮你合并

最常被忽略的一点：每次换设备后，Package Control 本身要先手动安装好，否则 Satisfy Dependencies 根本不会出现在命令面板里。