必须先彻底退出进程并清除残留数据,再仅提取packages/user目录——这是唯一能跨设备还原全部个性化设置的可靠方式。

直接删安装目录不能卸载 Sublime Text,更无法安全迁移配置;必须先彻底退出进程、清除残留数据,再只提取 Packages/User 目录——这是唯一能跨设备还原全部个性化设置(快捷键、构建系统、插件开关、主题路径)的可靠方式。
为什么不能用“控制面板卸载”或直接删程序文件夹
Sublime Text 的配置、插件、缓存、会话状态全存在用户数据目录里,和安装路径完全分离。你删掉 C:\Program Files\Sublime Text 或 /Applications/Sublime Text.app,%APPDATA%\Sublime Text(Windows)、~/Library/Application Support/Sublime Text(macOS)、~/.config/sublime-text(Linux)这些地方一个没动,重装后所有设置立刻“复活”。
- 控制面板卸载只清理注册表和安装目录,对用户数据零影响
- 某些插件(如 LSP 类)会在
Cache/里留下语言服务器进程,不杀进程就删目录会卡住 - 如果之前登过 Sync 账号,没执行
subl --sync-logout,首次启动就会从云端拉回全部配置
必须先彻底退出所有后台进程
窗口关了 ≠ 进程退出。Sublime Text 4 默认常驻后台,持续监听剪贴板、同步状态、LSP 请求,会锁死 Packages/ 和 Cache/ 下的文件。
- Windows:打开任务管理器 → 搜索
sublime_text.exe和subl.exe→ 全部“结束任务” - macOS:活动监视器中搜索
Sublime Text→ 强制退出;或终端执行killall "Sublime Text" - Linux:终端运行
pkill -f "sublime_text"或pkill -f "subl" - 别信托盘图标——macOS 用户务必点菜单
Sublime Text → Quit Sublime Text,不是关窗口
只备份 Packages/User 目录,其他一概不碰
Packages/User 是唯一集中存放所有用户级配置的目录:它包含 Preferences.sublime-settings、Default (Windows).sublime-keymap、Package Control.sublime-settings、MyBuild.sublime-build、各插件专属配置(如 EmmyLua.sublime-settings)等。漏一个,就可能让快捷键失效、插件不启用、构建命令找不到。
- 路径必须通过
Preferences → Browse Packages…确认——便携版指向Data\Packages,常规版才在%APPDATA%或~/Library/Application Support - 不要复制
Installed Packages/:那是.sublime-package缓存,删了重启后 Package Control 会自动重装(前提是Package Control.sublime-settings在User/里完好) - 不要复制插件源码目录(如
Packages/GitGutter/):新环境只需启用插件,源码由 Package Control 自动下载解压;手动拷会导致 Python 模块路径冲突、ImportError - 配色方案路径(如
"color_scheme": "Packages/Dracula/Dracula.tmTheme")只是引用,真正生效的是.tmTheme或.sublime-color-scheme文件本身——但这类文件属于插件资产,不是用户配置,不该放进迁移包
迁移后最容易被忽略的三件事
把 Packages/User 拷过去 ≠ 配置立即生效。Sublime 启动时会检查并重建缺失结构,但几个关键点不手动干预就会失败:
- 确认目标机器已关闭 Sublime —— 否则写入冲突,
Preferences.sublime-settings可能被覆盖回默认值 - 检查
Package Control.sublime-settings中的installed_packages字段是否完整;缺项会导致插件不自动重装 - 如果原环境用过 Sync 功能,新机器首次启动前需确保没登录账号,或提前运行
subl --sync-logout(Windows 需subl在 PATH 中)











