先看控制台最顶行堆栈定位问题插件,再查ignored_packages列表确认是否被静默忽略,最后检查文件结构和依赖;禁用插件须通过package control并重启,不可手动删文件夹。

插件报错弹窗反复出现,先看控制台最顶行堆栈
Sublime 的弹窗错误(比如“plugin_host has exited unexpectedly”)只是表象,真正线索藏在控制台里。按 Ctrl + ` 打开控制台后,错误堆栈最上面那行往往直接指向问题插件文件路径,例如:File "./Packages/SomePlugin/main.py", line 42, in on_activated。这比猜哪个插件坏了快得多。
常见陷阱是只盯着弹窗标题,忽略控制台里更早出现的 ImportError 或 AttributeError——它们可能已静默发生多次,直到某次触发崩溃才弹窗。
- 如果堆栈里出现
create_connection,基本锁定是旧插件误用了 Python 标准库函数,Sublime 的 urllib 不支持它 - 若堆栈含
ssl、certifi或urlopen相关报错,说明是 Package Control 自身网络层失败,和具体插件无关 - 堆栈末尾出现
NoneType is not callable或空指针类错误,大概率是插件主文件里某个回调函数被删了或没定义
禁用插件不是靠删文件夹,而是走 Package Control 禁用流程
手动删掉 Packages/SomePlugin 文件夹看似彻底,但容易漏掉 Installed Packages/SomePlugin.sublime-package,导致下次启动时 Sublime 加载压缩包又冲突。正确做法是通过 Package Control 禁用,确保加载链完全切断。
进菜单 Preferences → Package Control → Disable Package,选中目标插件名。重启 Sublime 后观察弹窗是否消失。如果消失了,说明就是它;如果还在,说明要么有多个插件叠加出问题,要么是 Sublime 自身组件(如 package_control.py)出错。
- 禁用后仍弹窗?检查控制台是否还有同名插件的残留日志,可能是大小写不同(如
emmet和Emmet被当成两个插件) - 禁用后弹窗变少但没根除?说明存在依赖链冲突,比如 A 插件依赖 B,B 崩溃导致 A 报错,此时要从底层插件开始禁用
- 别跳过重启——Sublime 不会热重载
ignored_packages列表,不重启等于没禁用
插件被自动加入 ignored_packages 却不提示,得手动翻配置
Sublime 在启动时发现插件签名异常、结构不全或 API 版本不匹配,会悄悄把它加进 ignored_packages 数组,然后彻底跳过加载。你找不到命令、快捷键无效、控制台安静如鸡,其实不是插件“坏了”,是它压根没被读进去。
打开命令面板,输入并执行 Preferences: Package Control,在控制台输出里搜 ignored_packages。如果看到目标插件名在列表里,就去 Preferences → Settings – User 里找到这一行,把插件名从数组中删掉。注意格式:引号、逗号、方括号一个都不能错。
- 改完设置不重启?Sublime 会继续用旧的 ignored 列表,插件依然失效
- 改完发现插件还是不显示?检查
Packages/目录下是否存在同名的.sublime-package文件,它会优先于文件夹被加载,删掉再试 - macOS/Linux 用户特别注意大小写:插件文件夹名必须和
ignored_packages里写的完全一致,Emmet≠emmet
手动安装插件后不生效,重点查三处物理结构
手动下载 ZIP 解压放进 Packages/ 是兜底方案,但最容易栽在细节上。Sublime 只认三种东西:文件夹名、主 Python 文件、无冲突结构。名字不对或缺关键文件,它就当没看见。
进 Preferences → Browse Packages…,确认插件文件夹存在且命名干净——不能带空格、版本号、下划线前缀,比如 SideBarEnhancements-master 必须重命名为 SideBarEnhancements。然后点进去看有没有 .py 主文件(如 sidebar_enhancements.py),以及是否混着 package-metadata.json(部分新插件强制要求)。
- 文件夹里只有
package-control.cache或空着?说明解压失败或下载的是源码 ZIP,不是发布版 - 有
.py文件但控制台刷ImportError: No module named 'mdpopups'?这不是插件问题,是它依赖的底层包缺失,得单独装mdpopups.sublime-package - 插件文件夹和同名
.sublime-package共存?Sublime 优先加载压缩包,删掉Installed Packages/下对应文件才能让文件夹生效
ignored_packages,最后动手翻磁盘——顺序错了,花两小时不如两分钟。









