重装系统后Sublime Text插件不加载,是因为仅同步Packages/User目录而遗漏Packages和Installed Packages;必须同步这两个目录并彻底退出程序后再复制,同时注意符号链接失效问题。

重装系统后,Sublime Text 默认是空的——插件不加载、主题变灰、快捷键失效、Ctrl+Shift+P 里搜不到命令。这不是配置“丢了”,而是你只恢复了 Packages/User,却漏掉了真正让插件跑起来的代码和缓存。
必须同步 Packages 和 Installed Packages 两个目录
只拷 Packages/User 是最常见误区。它只存你的设置文件(比如 Preferences.sublime-settings),但 SideBarEnhancements、EmmyLua 这些插件的功能逻辑,全在 Packages/SideBarEnhancements/ 这类子目录里;而 Installed Packages/ 则存着 Package Control 下载的 .sublime-package 压缩包,是插件自动启用的依据。
- Windows 路径:先用
Preferences → Browse Packages…确认真实位置,通常是%APPDATA%\Sublime Text\Packages和%APPDATA%\Sublime Text\Installed Packages - macOS 路径:
~/Library/Application Support/Sublime Text/Packages和~/Library/Application Support/Sublime Text/Installed Packages(终端中空格要写成\) - Linux 路径:
~/.config/sublime-text-4/Packages和~/.config/sublime-text-4/Installed Packages(注意版本号,ST4 是sublime-text-4) - 便携版完全另算:直接复制程序同级的
Data文件夹(大小写敏感,不是data)
同步前务必彻底退出 Sublime Text
运行时 Sublime 会持续写入 Installed Packages/ 中的 .sublime-package 文件,并热重载 Packages/ 下的插件目录。一边复制一边运行,极易产生损坏或残留(比如带 ~ 或 .tmp 的空文件夹)。
- Windows:任务管理器中结束所有
sublime_text.exe进程(包括托盘图标) - macOS:活动监视器里找
sublime_text,Force Quit - Linux:
ps aux | grep sublime找进程并kill - 验证方式:执行
Preferences → Browse Packages…,弹出窗口为空白或报错,说明已退出干净
遇到插件不加载?优先检查解压版 vs 压缩包冲突
如果 Packages/ 下已有某插件的完整目录(如 Packages/GitGutter/),而 Installed Packages/ 里还留着 GitGutter.sublime-package,Sublime 会优先加载解压版——但压缩包若未删,下次启动可能触发冲突或覆盖行为。
- 实操建议:保留
Packages/下的插件目录,删掉Installed Packages/中对应名称的.sublime-package文件 - 如果插件菜单变灰、右键无响应,可尝试在控制台(
Ctrl+`)执行view.run_command("satisfy_dependencies") - 部分插件(如 PackageResourceViewer)会自动生成缓存,不同设备上 Python 环境或换行符(CRLF vs LF)差异会导致静默失败,这类临时生成内容不用同步
同步完别急着开编辑器,先确认路径是否被符号链接劫持
如果你之前用过 mklink /J(Windows)或 ln -s(macOS/Linux)把 User 目录链到云盘,重装后这个链接大概率失效——它可能指向一个不存在的路径,或仍连着旧系统里的云盘位置。此时 Sublime 会安静地创建一个空的 User 目录,你的设置就“隐身”了。
- 打开
Preferences → Browse Packages…,看弹窗地址是否还是你预期的路径 - 如果是类似
C:\Users\XXX\AppData\Roaming\Sublime Text\Packages\User这样的真实路径,说明链接已断,需重新建立 - 若路径看起来像
D:\Dropbox\SublimeConfig\User,但该目录实际不存在,那得先修复云盘同步,再重建链接


















