插件目录损坏会导致Sublime Text启动慢、命令面板失效、右键菜单残留、CPU高占用及Ctrl+Shift+P无法打开;主因是强行中断安装、手动删半插件、LSP崩溃残留或同名插件在Packages/与Installed Packages/共存。

插件目录损坏的典型表现
Sublime Text 启动变慢、命令面板搜不到命令、右键菜单残留旧选项、CPU 持续 30%+ 占用,甚至 Ctrl+Shift+P 打不开——这些都不是单纯“卡”,而是插件目录(Packages/)里存在损坏或冲突的文件。常见诱因包括:强行中断安装、手动删了一半插件文件夹、LSP 插件崩溃后留下不完整缓存、或 Installed Packages/ 和 Packages/ 里同名插件共存。
手动清理损坏插件目录的实操步骤
别依赖 Package Control: Remove Package,它对已损坏的插件往往失效——命令面板根本列不出名字,或者点了没反应。必须进文件系统动手清:
- 先彻底杀掉所有 Sublime 进程:
sublime_text.exe(Windows)、Sublime Text(macOS)、sublime_text(Linux),否则文件被锁,删不动也删不全 - 打开
Packages/目录(用Preferences → Browse Packages…最稳,别手输路径) - 找并删掉对应插件的整个文件夹(如
Pyright、SideBarEnhancements),不是只删子文件;同时检查上一级的Installed Packages/,删掉同名的.sublime-package文件 - 去缓存目录搜插件关键词:
%LOCALAPPDATA%\Sublime Text\Cache\(Win)、~/Library/Caches/Sublime Text/(macOS)、~/.cache/sublime-text/(Linux),删掉含该插件名的整个文件夹 - Windows 用户可顺手在注册表
HKEY_CURRENT_USER\Software\Sublime Text里搜插件名,删掉相关键值(非必需但对顽固残留有效)
重装前必须验证的三个关键点
直接拖新插件进 Packages/ 或双击 .sublime-package 安装,大概率再次失败。重装前确认:
-
Packages/下没有同名残留文件夹,Installed Packages/下也没有同名.sublime-package -
Preferences → Settings – User里没有该插件的配置项(比如"pyright": { ... }),有就手动删掉整段 - 如果插件依赖外部服务(如
node、python),确认终端能直接运行node --version或python3 --version,路径没被改过
离线重装插件时最容易踩的坑
从 GitHub 下载 ZIP 解压后,有人把整个文件夹拖进 Installed Packages/,结果插件不加载——因为 Sublime 只认 .sublime-package 文件放那儿;而解压后的文件夹,必须扔进 Packages/ 根目录,且文件夹名必须和官方仓库名**完全一致、大小写敏感**(例如 EmacsProMode ≠ emacspromode)。
更隐蔽的问题是:某些插件(如 HTML-CSS-JS Prettify)要求系统已安装 node,且路径得在 PATH 里;若你改过 node 安装位置,光装插件没用,得去 Preferences → Package Settings → HTML-CSS-JS Prettify → Set `node` Path 里填绝对路径。
真正麻烦的从来不是“装不上”,而是“看似装上了,但部分功能静默失效”——比如快捷键冲突、语法高亮不触发、LSP server 启动失败却无报错。这种时候,Ctrl+` 打开控制台看最后一行错误,比反复重装有用得多。


















