只需同步packages/user/目录及其中package control.sublime-settings的installed_packages列表,package control即可自动安装缺失插件;切勿复制插件源码、installed packages或整个packages目录,否则易引发importerror或插件失效。

只靠同步 Packages/User/ 目录 + Package Control.sublime-settings 里的 installed_packages 列表,就能让插件安装状态自动对齐。 不需要复制插件源码、不推荐用 Sync Settings 插件上传 Gist、更别碰整个 Packages/ 或 Installed Packages/ 目录——那只会触发 ImportError: No module named 'package_control' 或插件菜单变灰。
为什么 installed_packages 列表是关键
Sublime Text 本身不“记住”你装过什么插件,它只在启动时读取 Packages/User/Package Control.sublime-settings 文件里的 installed_packages 字段。只要这个 JSON 数组完整(比如 ["Emmet", "SideBarEnhancements", "GitGutter"]),Package Control 就会在后台自动拉取并安装缺失的插件。
- 这个列表必须明文写在
Package Control.sublime-settings里,不能靠手动复制.sublime-package文件来“模拟安装” - 不同机器上插件版本可能略有差异,但 Package Control 会按需更新,无需强求完全一致
- 如果某台电脑上插件没装出来,先检查控制台是否有
error loading plugin,再确认该插件名是否拼写准确、大小写匹配(如"Origami"≠"origami")
同步前必须退出 Sublime Text
运行中 Sublime 会持续写入 Packages/User/,包括 Package Control.sublime-settings。一边改配置一边建符号链接,大概率导致文件被锁、内容截断或列表写入失败。
- Windows:任务管理器里确认没有
sublime_text.exe进程残留 - macOS/Linux:终端执行
ps aux | grep sublime,杀掉所有相关进程 - 重启后第一次打开,留意右下角是否弹出“Installing packages…”提示——这是正常行为
mklink /J 和 ln -s 的实际路径要严格匹配版本
ST4 的路径和 ST3 不同,硬套旧教程会链接到空目录,installed_packages 列表根本不会被读取。
- Windows ST4 正确路径:
mklink /J "%APPDATA%\Sublime Text 4\Packages\User" "D:\Dropbox\SublimeConfig\User" - macOS ST4 正确路径:
ln -s ~/Dropbox/SublimeConfig/User ~/Library/Application\ Support/Sublime\ Text\ 4/Packages/User - Linux ST4 正确路径:
ln -s ~/Dropbox/SublimeConfig/User ~/.config/sublime-text-4/Packages/User - 路径含空格或中文?所有路径必须用英文双引号包裹,否则命令直接报错
color_scheme 和插件依赖文件容易漏同步
Preferences.sublime-settings 里写的 "color_scheme": "Packages/Color Scheme - Default/Mariana.sublime-color-scheme" 是相对路径,但文件本身不在 User/ 里;某些插件(如 Theme - Soda)的皮肤资源也散落在其他目录。
- 先在 Sublime 中打开
Preferences → Settings,找到color_scheme值,按Ctrl+P输入goto: file跳转到对应 .tmTheme 或 .sublime-color-scheme 文件 - 把这个文件复制到云盘的
SublimeConfig/同级目录(比如SublimeConfig/themes/Mariana.sublime-color-scheme),并在另一台电脑上用符号链接或手动替换 - 插件自身带的资源(如图标、模板)一般不用同步,但如果你用了自定义主题或修改过插件的
.py文件,就得单独处理——这类操作已超出“保持插件安装一致”的范畴
最常被忽略的是:同步完成后,新设备首次启动时 Package Control 需要几秒时间批量安装插件,期间快捷键和命令面板可能暂时不可用。这不是失败,是正常流程。等右下角提示消失,再验证 Ctrl+Shift+P 是否能搜到 Emmet、GitGutter 等命令即可。











