sublime插件报“1 missing dependency”或importerror,是因独立python环境缺少指定依赖模块;需从报错信息提取准确模块名(如mdpopups),下载对应.sublime-package文件放入installed packages/目录并重启;若被ignored_packages屏蔽或路径/命名不合规,也会导致加载失败。

Sublime安装插件时提示“1 missing dependency was just installed”或控制台报ImportError,说明插件运行所需的Python模块未被正确加载,不是网络卡顿也不是插件损坏,而是Sublime的独立Python环境里缺了关键依赖文件。
确认缺失的是哪个依赖
打开控制台(View → Show Console),触发一次插件命令(比如按Ctrl+Shift+P输入插件名并回车),看报错信息里明确写的模块名,例如ImportError: No module named 'mdpopups'——这行里的mdpopups就是你要找的依赖名。
别凭印象猜,也别直接搜“Sublime 依赖包下载”,必须从报错原文提取准确名称。
手动安装缺失的.sublime-package依赖
方法一:从官方维护仓库下载预编译包
去对应依赖的GitHub Releases页面搜索,例如mdpopups项目地址是https://github.com/titoBouzout/MDPopups/releases,找到最新版带“.sublime-package”后缀的发布文件(不是Source code ZIP)。
下载后,把该文件直接拖进Sublime的Installed Packages/目录——不是Packages/,也不是任意子文件夹。
【必须重启Sublime】,否则新依赖不会被Python解释器识别。
方法二:用Package Control强制同步(仅适用于已知在channel中存在但缓存失效的情况)
按Ctrl+Shift+P → 输入Package Control: Synchronize Packages → 等待右下角出现Finished synchronizing packages。
这一步会重新拉取所有依赖的元数据,但前提是该依赖已被收录进你当前配置的channel列表中;若报错仍存在,说明它不在channel里,必须走方法一。
检查依赖是否被ignored_packages屏蔽
第一步:打开Preferences → Settings – User,查看右侧用户配置中是否有"ignored_packages"字段。
第二步:如果该字段值是一个数组,且里面包含你刚装的依赖名(如"mdpopups"、"pygments"),它就会被Sublime跳过加载——即使文件放对了位置,也不会生效。
第三步:删掉数组中对应项,或整行注释掉(加//前缀),保存后【必须完全退出Sublime再重开】,Windows/macOS下只关窗口不等于退出进程。
验证路径和命名是否合规
进入Preferences → Browse Packages…,确认打开的是Packages/目录;它的同级目录Installed Packages/才是.sublime-package文件的落点。
检查你放入Installed Packages/的文件名:必须是xxx.sublime-package格式,不能是xxx.zip、xxx-master.sublime-package、xxx-1.2.3.sublime-package,也不能有中文、空格或特殊符号。
解压后的依赖(极少数情况需要)必须整体放进Packages/,且文件夹名要与模块导入名一致——比如代码里写import jinja2,那文件夹就必须叫jinja2,不能叫python-jinja2或Jinja2。











