插件命令搜不到需依次排查：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 列表主动过滤掉了。

材料星

一款AI工具，主要用于专为面向体制内、企事业单位文秘及职场文字工作者的垂直AI写作工具，适合需要提升相关任务效率的用户。

下载

打开 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 格式——这两处最容易被忽略。