Sublime Text 卸载插件后仍卡顿报错,因 Package Control: Remove Package 仅删除代码文件,不清理配置(Packages/User/)、缓存(Cache/)和同步状态(Local/或Saved Application State/),需手动清除三类残留并彻底结束进程。

Sublime Text 没有真正意义上的“一键清理冗余插件”功能——Package Control: Remove Package 只删代码,不碰配置、缓存、同步状态,残留必导致 CPU 飙高、右键菜单还在、命令面板能搜到但执行报错。
为什么 Package Control: Remove Package 卸了还卡还报错
它只做两件事:Packages/GitGutter/ 目录和 Installed Packages/GitGutter.sublime-package 文件。其余三处全留着:
-
Packages/User/GitGutter.sublime-settings—— 配置残留会让 Sublime 启动时仍尝试加载相关逻辑 -
Cache/下以插件名命名的子文件夹(如pyright、texlab)—— 存语言服务器 socket、索引、编译产物,损坏后后台死循环拉起进程 -
Local/或Saved Application State/中的注册项 —— 导致右键菜单项仍在、折叠状态错乱、甚至“卸了又自动恢复”
删插件前必须关死所有 Sublime 进程
窗口关了 ≠ 进程退出。LSP 服务、剪贴板监听、同步代理都可能让进程常驻,导致文件被锁、删不干净、重启后“复活”:
- Windows:任务管理器中搜索
sublime_text.exe和subl.exe,全部结束 - macOS:活动监视器中搜索
Sublime Text,强制退出所有实例 - Linux:终端运行
pkill -f "sublime_text"或pkill -f "subl"
必须手动清的三类残留位置
只删 Packages/ 目录下的插件文件夹是无效劳动。以下三类路径缺一不可:
-
配置残留:进
Packages/User/(可通过Preferences → Browse Packages…快速打开),删所有含插件关键词的文件,如LSP-pyright.sublime-settings、GitGutter.sublime-keymap;再打开Preferences.sublime-settings,删掉"ignored_packages": ["GitGutter"]这类已失效字段 -
缓存残留:按系统清对应
Cache和Index目录
Windows:%APPDATA%\Sublime Text\Cache、%LOCALAPPDATA%\Sublime Text\Cache、%APPDATA%\Sublime Text\Local\Index
macOS:~/Library/Application Support/Sublime Text/Cache、~/Library/Caches/Sublime Text、~/Library/Application Support/Sublime Text/Local\Index
Linux:~/.config/sublime-text/Cache、~/.cache/sublime-text、~/.config/sublime-text/Local\Index -
同步残留:只要执行过
subl --sync-login,重装或重启后就会从云端拉回插件列表和设置。务必先运行subl --sync-logout(Windows 需确保subl在 PATH),或通过菜单栏Sublime Text → Preferences → Sync Settings → Logout;也可查Packages/User/Package Control.sublime-settings是否含"sync_login"字段
删完重启仍异常?重点盯这三处
常见“以为清完了,其实没清”的盲区:
-
Context.sublime-menu文件常被忽略——它硬编码右键菜单项,位于Packages/User/或原插件目录下,需手动搜索并删掉含"command": "git_gutter_stage_hunk"的整行 -
~/.cache/sublime-text/(Linux/macOS)或%LOCALAPPDATA%\Sublime Text\Cache\(Windows)里可能有多个同名插件缓存(如pyright和LSP-pyright),得全搜全删,不能只删一个 -
Local/State或Saved Application State/com.sublimetext.4/(macOS)会偷偷恢复 UI 状态和插件行为,删前建议先重命名备份,确认无误再彻底删除


















