插件命令搜不到需依次排查:Package Control是否加载、sublime版本是否匹配安装脚本、.sublime-package文件是否放对目录(Installed Packages/)、插件是否被ignored_packages屏蔽、依赖模块是否以.sublime-package格式正确安装。

插件命令搜不到?先看 Package Control 有没有真正加载
Package Control 不在运行时里,所有插件安装都等于白干。按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Package Control —— 如果一行结果都没有,说明它根本没启动。
打开控制台(Ctrl+`),执行 sublime.version() 确认版本:返回 4xxx 是 ST4,必须用带 hashlib.sha256 校验的安装脚本;返回 3xxx 建议升级,旧版 TLS 兼容性差,容易静默失败。
- 删掉
Installed Packages/下所有含Package Control的文件(包括残留的Package Control.sublime-package) - 粘贴并执行官网最新 ST4 安装代码,看到
Success才算落盘成功 - 必须彻底退出 Sublime(右键任务栏选「退出」,不是关窗口),再重启验证
.sublime-package 文件放错目录,Sublime 会直接跳过
手动安装时,.sublime-package 文件和解压后的文件夹绝不能混放——Sublime 对路径极其敏感,放错就静默忽略,连控制台都不报错。
最可靠的方法:菜单栏点击 Preferences → Browse Packages…,打开的目录就是 Packages/;它的上一级才是 Installed Packages/。
-
Emmet.sublime-package这类单文件 → 必须放进Installed Packages/,不解压、不改名、不嵌套 - 从 GitHub 下载的 ZIP(如
Emmet-master.zip)→ 解压后取主文件夹(含__init__.py或emmet.py的那个),重命名为规范名(如Emmet),整个文件夹拖进Packages/根目录 - 千万别把
.sublime-package文件拖进Packages/,也别把解压后的文件夹扔进Installed Packages/
插件被 ignored_packages 静默屏蔽,重启才生效
这是最隐蔽的问题:插件明明放对了位置,也重启了,但命令面板搜不到、快捷键不触发、菜单不出现——大概率是被 ignored_packages 列表主动过滤掉了。
打开 Preferences → Settings – User,检查是否有 "ignored_packages" 字段。如果刚装的插件名(比如 "GitGutter")出现在这个列表里,它就会被完全忽略。
- 删掉对应项,或整行注释掉,保存后必须重启 Sublime 才生效
- 某些插件(如
Origami)需要额外启用命令面板里的初始化项,不是放进去就自动弹窗 - 如果不确定是否被屏蔽,可临时清空
ignored_packages数组,重启后测试
依赖模块缺失导致 ImportError,pip install 无效
控制台反复刷出类似 ImportError: No module named 'mdpopups',这不是插件坏了,是它依赖的底层模块没装对。Sublime 的 Python 环境完全隔离,pip install 在系统里装的包对它毫无作用。
所有依赖必须以 .sublime-package 形式放进 Packages/ 目录,且命名要和 import 语句完全一致。
- 去对应仓库 Releases 页面下载官方发布的
mdpopups.sublime-package(不是源码 ZIP),放入Packages/ - 确保文件名大小写、拼写、后缀都和报错信息中的一致(比如
mdpopups≠MDPopups) - 部分插件依赖多个模块(如
python-jinja2、markupsafe),需一并下载对应.sublime-package文件
路径、权限、配置、依赖这四点卡住任意一个,插件都会“装上了却没反应”。尤其注意 ignored_packages 修改后必须重启,以及依赖模块必须用 .sublime-package 格式——这两处最容易被忽略。

















