必须关闭Sublime Text再操作,否则配置会被覆盖或损坏;需完整复制Packages/User、Packages/下非User插件目录及配色方案文件;路径须通过Browse Packages…确认;恢复后检查ignored_packages和控制台日志。

关掉 Sublime Text 再操作,否则配置会被覆盖或损坏
Sublime Text 运行时会持续写入 Packages/ 和 Installed Packages/ 目录,边复制边运行极易导致:
• Preferences.sublime-settings~ 临时文件残留
• 插件目录结构错乱,重启后报 reloading plugin XXX failed
• Package Control.sublime-settings 被重置,已启用插件列表清空
确认进程已退出的方法:
• Windows:任务管理器中查 subl.exe 或 sublime_text.exe,不能只关窗口
• macOS:活动监视器搜 Sublime Text,或终端执行 killall "Sublime Text"
• Linux:终端运行 pkill -f "sublime_text"
只复制 Packages/User 目录不够,插件不会加载
很多人恢复后发现快捷键还在、字体正常,但右键菜单空白、Ctrl+Shift+P 搜不到插件命令——这不是配置没生效,是插件压根没装上。
Packages/User 只存配置,不存插件代码:
• Preferences.sublime-settings:字体、缩进、主题路径等
• Package Control.sublime-settings:插件启用状态(关键!漏它就全灰)
• Default (Windows).sublime-keymap:自定义快捷键
• SideBarEnhancements.sublime-settings:插件专属设置
但 SideBarEnhancements 的功能逻辑在 Packages/SideBarEnhancements/ 目录里,必须一并复制
要完整恢复,需复制三类内容:
• Packages/User 整个文件夹(必须)
• Packages/ 下所有非 User 的子目录(如 GitGutter、EmmyLua、Dracula Color Scheme)
• 配色方案文件本身(如 Packages/Dracula/Dracula.tmTheme),不是设置里写的路径
路径必须用 Browse Packages… 确认,别硬记
不同系统、ST 版本(3/4)、是否便携版,Packages/User 的物理位置完全不同:
• macOS 路径含空格:~/Library/Application Support/Sublime Text/Packages/User,终端里得写成 Application\ Support
• Linux 区分 sublime-text-3 和 sublime-text(ST4)
• Windows ST4 路径是 Sublime Text(带空格),不是 Sublime Text4
• 便携版指向 Data\Packages,硬套 %APPDATA% 必错
最准方法永远是:
启动 Sublime Text → Preferences → Browse Packages…
弹出的窗口地址就是你要操作的真实路径
如果指向 Data\Packages,你就在用便携版——别去翻 %APPDATA%
恢复后插件仍不生效?检查 ignored_packages 和控制台日志
即使路径和文件都对,插件也可能静默失效:
• 打开 Preferences.sublime-settings,检查是否有 "ignored_packages": ["GitGutter"] 这类条目,把它删掉
• 按 Ctrl+` 调出控制台,看有没有 reloading plugin GitGutter 日志
• 如果有 ImportError: No module named 'package_control',说明 Package Control.sublime-package 没放对位置(必须在 Installed Packages/,不能丢进 Packages/)
特别注意:
• ST4 更新后,旧版 .sublime-package 文件可能不兼容,建议重装 Package Control 后用它自动安装
• 主题若用 .tmTheme 格式,但插件目录里实际是 .sublime-color-scheme,ST4 会优先读后者,前者被忽略


















