必须分清两类文件格式和对应目录：.sublime-package文件直投installed packages/，不解压不改名；github zip解压后需重命名（去-master等后缀）再整体放入packages/根目录；放错则静默跳过不加载。
能装，但必须分清两类文件格式和对应目录——.sublime-package 文件只能进 Installed Packages/，GitHub 下载的 ZIP 解压后文件夹必须重命名再扔进 Packages/ 根目录；放错位置，Sublime 会静默跳过，不报错也不加载。
怎么确认插件该放 Packages 还是 Installed Packages？
别猜，直接查路径：
- 菜单 → 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项验证
最容易被忽略的是路径层级和命名一致性——Sublime 不会提示“放错位置”，它只是沉默地跳过；ignored_packages 列表也从不报错，只让插件彻底消失。重启前务必确认进程已完全退出，尤其 macOS 上残留后台进程会导致设置不生效。
