只同步 Packages/User/ 目录就足够了,因其包含所有个性化配置文件(.sublime-settings、.sublime-keymap、.sublime-snippet),但需额外同步 color_scheme 引用的 .tmTheme 或 .sublime-color-scheme 文件;推荐用符号链接+云盘实现自动同步,避免 Git 延迟或手动复制遗漏。

只同步 Packages/User/ 目录就足够了
Sublime Text 的所有个性化配置——包括主题、缩进、字体、快捷键、插件列表、代码片段、侧边栏设置,甚至各插件的用户级配置(如 SideBarEnhancements.sublime-settings)——都明文存放在 Packages/User/ 下。它不包含插件源码、Python 缓存(__pycache__/)、会话文件(Session.sublime_session)或本地缓存(Package Control.cache)。硬拷整个 Packages/ 或 Data/ 目录,反而大概率触发:ImportError: No module named 'package_control'、插件菜单变灰、.sublime-snippet 在 Ctrl+Shift+P 中可见但按 Tab 不展开(XML 解析静默失败)。
真正要同步的只有三类文件:
-
*.sublime-settings(如Preferences.sublime-settings、Package Control.sublime-settings) -
*.sublime-keymap(如Default (Windows).sublime-keymap) *.sublime-snippet
注意:color_scheme 字段引用的 .tmTheme 或 .sublime-color-scheme 文件不在 User/ 里,需单独找出来一并同步。
用符号链接 + 云盘实现零手动操作同步
这是最轻量、最接近“自动”的方式,适合两台个人电脑间快速对齐。核心是把 User/ “挂载”过去,而不是复制粘贴。
操作前必须完全退出 Sublime Text,否则文件被锁,链接会失败或内容不同步。
步骤简明:
- 用
Preferences → Browse Packages…确认当前User/路径(ST4 用户注意路径含Sublime Text 4) - 将整个
User/文件夹剪切到云盘(如Dropbox/SublimeConfig/User) - 删除原
User/目录(不是重命名,否则链接无效) - 在原位置创建符号链接:
Windows(管理员 CMD):mklink /J "C:\Users\用户名\AppData\Roaming\Sublime Text 4\Packages\User" "D:\Dropbox\SublimeConfig\User"
macOS/Linux(终端):ln -s ~/Dropbox/SublimeConfig/User ~/Library/Application\ Support/Sublime\ Text\ 4/Packages/User
iCloud 和 OneDrive 对 ~/Library 或 %APPDATA% 同步支持不稳定,Dropbox 或 坚果云更可靠。
为什么不用 Git 或直接复制?
Git 适合需要版本回溯、多人协作或跨平台换行符(CRLF/LF)精细控制的场景,但它不是实时同步:你得 git add、git commit、git push、另一台再 git pull,中间有延迟,且容易因冲突卡住。
直接复制 User/ 文件夹虽能用,但每次换电脑都要手动操作一遍,漏掉一个 .sublime-snippet 或 Package Control.sublime-settings 就会导致插件没装全、片段不生效——看似快,实则不可持续。
符号链接方案下,你在 A 机改一个快捷键,几秒内 B 机重启 Sublime 就生效,且无需任何命令干预。
同步后插件没加载?先检查这两点
即使 User/ 正确同步,插件仍可能不工作,常见原因:
-
Package Control.sublime-settings中的installed_packages列表已同步,但插件本身没下载:重启 Sublime 后,Package Control 会自动拉取缺失插件;若没反应,手动执行Package Control: Install Package再选几个试试 - 某插件依赖其他插件或 Python 模块(比如
BracketHighlighter依赖Pygments),而后者未被installed_packages记录:这时需在新设备上手动安装依赖,或在原设备执行Package Control: Satisfy Dependencies后再同步
跨设备同步最脆弱的环节不在配置文件本身,而在插件生态的隐式依赖和缓存状态——User/ 是唯一可信的起点,其余都该由 Sublime 在运行时重建。


















