只同步user目录就够了,因为sublime所有个性化配置——主题、快捷键、插件列表、代码片段、侧边栏设置等均集中于此,不含插件源码或运行缓存,跨设备兼容性高;同步整个packages或data会混入缓存、session等易引发importerror或菜单异常的文件。

User 目录同步就能实现换电脑秒恢复,其他路径同步反而大概率出错。
为什么只同步 User 目录就够了
Sublime Text 的所有个性化配置——主题、快捷键、插件列表、代码片段、侧边栏设置——都存在 User 目录里。它不包含插件源码或运行时缓存,所以跨设备兼容性高。
-
Preferences.sublime-settings控制字体、缩进、UI 行为 -
Default (Windows).sublime-keymap或对应平台文件定义快捷键 -
Package Control.sublime-settings里installed_packages字段记录已装插件 - 插件自身的配置(如
Emmet.sublime-settings)也都在这个目录下
同步整个 Packages 或 Data(便携版)会混入 Python 编译缓存(__pycache__)、Session 文件、.cache,不同机器上容易触发 ImportError: No module named 'package_control' 或插件菜单变灰。
ln -s / mklink /J 是最稳的自动同步方式
符号链接把云盘里的 User 目录“挂载”到 Sublime 原始读取路径,修改实时生效,无需手动拉取。
- macOS/Linux:先退出 Sublime,执行
ln -s ~/Dropbox/SublimeConfig/User ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/User - Windows(管理员 CMD):同样先退出,执行
mklink /J "C:\Users\用户名\AppData\Roaming\Sublime Text 3\Packages\User" "D:\Dropbox\SublimeConfig\User" - iCloud 和 OneDrive 对
~/Library或%APPDATA%同步支持不稳定,Dropbox 或 坚果云更可靠 - 链接前务必删掉原
User文件夹,不能重命名,否则链接失败
Git 同步适合需要回滚和审计的用户
Git 不自动同步,但能防止误删、覆盖或配置漂移,尤其适合多台设备频繁切换的场景。
- 在
User目录下建.gitignore,至少排除:*.cache、Session.sublime_session、Local/、Cache/ - 提交时用
git add -f *.sublime-settings *.sublime-keymap *.sublime-snippet,避免漏掉隐藏文件 - 新设备克隆后,要先安装
Package Control,再替换User,否则installed_packages列表不会触发自动下载 - 别用
git push同步二进制文件(如 .tmTheme),它们无法 diff,且容易冲突
容易被忽略的三个细节
同步成功 ≠ 环境完全一致。以下三点不处理,常导致“看着一样,用着不对”:
- 不同系统换行符(CRLF/LF)会让
.sublime-keymap解析失败,建议统一设为 LF(Sublime 自带 “Set Line Endings” 功能) - 某些插件(如
SideBarEnhancements)依赖本地路径或注册表,需在每台设备单独运行一次Satisfy Dependencies - Sublime Text 3 和 4 的
User路径不同(Sublime Text 3vsSublime Text 4),混用会导致配置不加载











