插件必须按格式严格分放：.sublime-package 文件直投 installed packages/ 目录，github zip 解压后重命名文件夹（去-master/-main等后缀）再整体放入 packages/ 根目录；路径错误、ignored_packages 屏蔽或语法作用域不匹配会导致静默失效。
能快速部署，前提是插件包已提前下载好、且你清楚它属于哪一类格式——.sublime-package 文件和 GitHub ZIP 解压后的文件夹，处理方式完全不同，混放或放错目录就会彻底失效。
怎么确认插件该扔进 Packages 还是 Installed Packages？
别靠记忆或网上搜的路径猜，直接在 Sublime 里查：
- 菜单 → Preferences → Browse Packages… 打开的目录就是
Packages/（所有解压后插件文件夹都往这儿塞） - 在这个窗口里往上退一级，找到
Installed Packages/目录（所有.sublime-package文件只准放这儿） - 不确定？按
Ctrl+`调出控制台，输入print(sublime.packages_path())和print(sublime.installed_packages_path())，回车看真实路径
.sublime-package 文件必须直投 Installed Packages，不改名不解压
这类文件本质是 ZIP 压缩包，Sublime 启动时自动解压加载。常见于 Package Control 官方分发或从其他机器拷来的插件：
- 文件大小必须在 180–220 KB（比如
Package Control.sublime-package小于 100 KB 就是下载损坏） - 拖进去前，先清空
Installed Packages/下所有含Package Control字样的文件（ST4 对旧版静默失败） - 重启后按
Ctrl+Shift+P搜Package Control: List Packages，能列出才算真正加载成功
GitHub 下载的 ZIP 必须重命名后整体扔进 Packages 根目录
点 Download ZIP 得到的压缩包，解压后默认是 Emmet-master/ 或 ConvertToUTF8-main/ ——这层后缀是 GitHub 自动生成的包装壳，Sublime 不识别：
- 把
Emmet-master/重命名为Emmet/，Origami-dev/改成Origami/，大小写、空格、下划线一个都不能多 - 整个重命名后的文件夹直接拖进
Packages/根目录，不能放进User/或其他子文件夹 - 检查文件夹内至少有一个
.py文件，且类继承自sublime_plugin.TextCommand或sublime_plugin.EventListener
插件“装上了”但命令不出现？先盯住 ignored_packages 和语法作用域
这是最常被忽略的假性失败：
- 打开 Preferences → Settings，右侧用户配置里搜
ignored_packages，如果刚装的"Emmet"在列表里，它就被彻底屏蔽 - 插件常绑定特定语法：比如
Vue Syntax Highlight只响应.vue文件或作用域text.html.vue，开.html文件时右下角显示HTML，它就完全沉默 - 临时验证：按
Ctrl+Shift+P输入Set Syntax:切换到对应语法，再试命令；或注释掉ignored_packages行，保存后必须重启才生效
真正卡住的往往不是下载或解压，而是路径层级、文件夹名大小写、ignored_packages 静默屏蔽这三处——Sublime 从不报错，它只是沉默跳过。动手前多花十秒查一次真实路径和用户设置，比反复重启高效得多。
