彻底卸载Sublime Text插件需三步:先删Packages目录下插件文件夹,再清Packages/User中相关配置文件,最后清理Cache目录缓存;否则重装后易出现行为异常、设置失效等问题。

Package Control: Remove Package 只能卸载插件本体,**不会动任何配置、缓存、日志或临时文件**。如果你遇到重装同名插件后行为异常、设置不生效、启动变慢或报错(比如 LSP-pyright 重复初始化、GitGutter 图标错位),大概率是旧残留在作祟。
找到并删除 Packages 目录下的插件主文件夹
这是最常被忽略的第一步——很多用户以为“删了插件就没了”,其实只是删了 Installed Packages 里的 .sublime-package,而真正运行的代码和配置往往在 Packages 文件夹里。
- 关闭 Sublime Text(必须!否则文件可能被占用)
- 打开插件目录:
Windows:%APPDATA%\Sublime Text\Packages\
macOS:~/Library/Application Support/Sublime Text/Packages/
Linux:~/.config/sublime-text/Packages/ - 查找与插件同名的文件夹(如
SideBarEnhancements、BracketHighlighter),直接整个删除 - 别只删子文件——有些插件会建多层结构(比如
LSP下还有LSP-pyright子目录),要删干净整棵树
顺手清掉 User 目录里的 .sublime-settings 和缓存文件
插件的用户级配置默认存在 Packages/User/ 下,命名通常是 PluginName.sublime-settings 或 PluginName.sublime-project。这些文件不会随插件卸载自动消失,下次重装时会被直接读取,导致“明明重装了却还是老样子”。
- 进入
Packages/User/目录(可通过 Sublime 菜单:Preferences → Browse Packages…快速打开) - 搜索关键词,例如:
GitGutter、Emmet、Alignment,删掉所有匹配的.sublime-settings、.sublime-keymap、.sublime-menu文件 - 某些插件还会建同名子文件夹(如
Emmet/、Terminus/),也一并删掉
清理缓存与系统级残留路径
部分插件(尤其是 LSP 类、语法高亮增强类)会在系统缓存目录写入编译产物或索引文件,不清理会导致新旧版本冲突、CPU 占用飙升、甚至无法启动。
- Windows:
%LOCALAPPDATA%\Sublime Text\Cache\和%APPDATA%\Sublime Text\Cache\ - macOS:
~/Library/Caches/Sublime Text/和~/Library/Application Support/Sublime Text/Cache/ - Linux:
~/.cache/sublime-text/和~/.config/sublime-text/Cache/ - 进对应目录后,用文件名搜索插件关键字(如
pyright、texlab),删掉相关文件夹;也可直接清空整个Cache目录(安全,重启后自动重建)
验证是否真清干净:用 find / search 快速定位残留
手动翻文件夹容易漏,尤其当插件名带空格、大小写混用(如 SublimeLinter vs sublimelinter)或用了缩写时。
- Linux/macOS 终端执行:
find ~/.config/sublime-text -iname "*gitgutter*" 2>/dev/null
- Windows PowerShell 执行:
Get-ChildItem -Path "$env:APPDATA\Sublime Text", "$env:LOCALAPPDATA\Sublime Text" -Recurse -ErrorAction SilentlyContinue | Where-Object {$_.Name -match "gitgutter|pyright"} - 看到任何结果?说明还有残留,按路径逐个删掉
Packages/User/ 下的配置文件和 Cache/ 目录里的二进制索引,它们不动声色,但影响最大。










