插件失效主因是被ignored_packages屏蔽、路径错误或python环境污染;需先查控制台输出及用户设置中ignored_packages字段,移除对应插件名并彻底重启sublime,同时确保.sublime-package放installed packages/、解压插件放packages/根目录。

插件失效不是“坏了”,而是 Sublime 在后台悄悄跳过了它——90% 的情况是被 ignored_packages 屏蔽、路径放错、或 Python 环境污染导致依赖加载失败。
插件命令搜不到?先查是否被 ignored_packages 自动禁用
Sublime 启动时会扫描所有插件,一旦发现签名异常、API 版本不匹配或初始化报错,就会把它加进 ignored_packages 黑名单,且不提示。你看到的“没装上”,其实是“装了但被拒之门外”。
- 打开控制台(
Ctrl+`),搜ignored_packages或disabled packages,看输出里有没有你的插件名(比如"Emmet"、"Terminus") - 打开
Preferences → Settings – User,检查是否有"ignored_packages"字段;如果有,整行删掉,或从中移除对应插件名(注意英文双引号和逗号格式) - 改完必须保存并**完全退出 Sublime**(Windows 任务管理器里确认
subl.exe进程已结束),再重启,否则配置不生效
手动安装的插件不加载?路径和文件类型必须严格匹配
.sublime-package 文件和解压后的文件夹,存放位置和命名规则完全不同,放错一格就静默失效。
-
.sublime-package文件(如Package Control.sublime-package)必须放进Installed Packages/目录,不能扔进Packages/ - 解压后的插件文件夹(如
Terminus/)必须整体放进Packages/根目录,路径应为Packages/Terminus/xxx.py,不能是Packages/User/Terminus/或Packages/Terminus/Terminus/ - Windows 用户特别注意:
%APPDATA%\Sublime Text 3\Packages\是正确路径,别误点进Roaming\Sublime Text 3\Packages下的快捷方式 - 装完别只点“重载”,必须重启 Sublime —— 它只在启动时扫描
Installed Packages/和Packages/两个目录
控制台反复刷 ImportError?别 pip install,要下 .sublime-package 依赖
Sublime 的 Python 是嵌入式沙箱(ST4 用 Python 3.8+),不认系统 pip,也不加载 PYTHONPATH。所有依赖模块必须以 .sublime-package 形式存在。
- 报
ImportError: No module named 'mdpopups'?去 GitHub 搜mdpopups,找releases页下载官方发布的mdpopups.sublime-package(不是源码 ZIP),放进Installed Packages/ - 同理,
python-jinja2要用 skuroda 维护的 Sublime 分支;pygments必须下完整版pygments.sublime-package - 别在控制台里运行
import requests测试——Sublime 的 requests 是自带的,和你系统装的无关;真正该看的是堆栈第一行:File "./Packages/Terminus/terminus.py",这才是问题源头
Terminus / 汉化 / Package Control 全挂了?大概率是 Python 环境被劫持
当多个插件同时失效、控制台报一堆 ImportError 或 ModuleNotFoundError,基本可断定 Sublime 的内置 Python 被外部解释器覆盖了。
- 检查
Preferences → Package Settings → Package Control → Settings,确认没有手动写"python_binary": "/opt/anaconda3/bin/python"这类配置 - Linux/macOS 用户:别用终端启动 Sublime(如
subl .),它会继承 shell 的PYTHONPATH或pyenv环境;直接从桌面图标或应用菜单启动 - Windows 用户:检查是否装了搜狗/QQ 拼音——它们常劫持
Ctrl+Alt+M,导致 Terminus 快捷键无响应;先切到微软拼音再试 - 终极验证:关闭所有窗口,删掉
Packages/Package Control/文件夹和Cache/目录,再重新安装Package Control.sublime-package到Installed Packages/
最易被忽略的一点:Sublime 不会在你改完配置后自动重载插件,哪怕你点了“Reload Plugin”。所有路径、ignored_packages、依赖包的变更,都必须伴随一次**彻底退出 + 重启**,否则永远卡在旧状态。











