sublime插件需严格分发至packages或installed packages目录：.sublime-package文件放installed packages；github zip解压后取含__init__.py的子文件夹，重命名规范后放入packages。
Sublime插件安装包该解压到哪个目录？
不是“随便找个文件夹扔进去”，而是严格按文件类型分发到两个不同目录：Packages 或 Installed Packages。放错位置，插件就永远不会加载——Sublime 不会报错，只会静默忽略。
-
.sublime-package文件（如PackageControl.sublime-package）→ 直接丢进Installed Packages目录，不要解压 - GitHub 下载的 ZIP（如
Emmet-master.zip）→ 解压后得到一个带-master后缀的文件夹 → 进入该文件夹，把真正含__init__.py的子文件夹（比如Emmet/）拎出来 → 重命名为规范名（Emmet，不能是emmet或Emmet-master）→ 整个文件夹复制进Packages根目录 - Windows/macOS/Linux 默认路径都不可靠；唯一可信方式是菜单 Preferences → Browse Packages…，它打开的就是当前生效的
Packages目录；同理，Installed Packages在其上一级目录里
为什么解压后插件不生效？常见静默失败原因
Sublime 不会弹窗告诉你“插件加载失败”，只会在控制台（Ctrl+`）里输出 reloading plugin XXX failed 或干脆什么也不显示。最常踩的坑是：
- 把 GitHub 解压出的
Emmet-master/文件夹整个拖进了Installed Packages—— 这里只认.sublime-package压缩包，插件文件夹放进来等于扔进黑洞 - 在
Packages里建了emmet/（小写）或Emmet /（末尾空格），Sublime 对大小写和空格极其敏感，直接跳过加载 - 多版本共存（ST3 和 ST4 同时装），手动拼路径时误把插件装到了另一个版本的
Packages下，而当前运行的是另一版 - 便携版没建对
Data文件夹：必须与sublime_text.exe同级、严格命名为Data（不能是data、DATA或Data1），否则 Sublime 退回到系统默认路径，你往自定义目录里放的插件全白忙
如何验证插件是否真被识别？
别靠“重启看看有没有新菜单”这种模糊判断。打开控制台（Ctrl+`），输入：
print(sublime.packages_path())
再输：
print(sublime.installed_packages_path())
这两行输出的路径，就是 Sublime 实际读取的两个根目录。然后去文件管理器里确认：
- 你要装的插件文件夹（如
BracketHighlighter）是否真实存在于packages_path()返回的路径下 - 你要装的
.sublime-package文件是否真实存在于installed_packages_path()返回的路径下 - 插件文件夹内是否有至少一个
.py文件，且其中定义了继承自sublime_plugin.TextCommand或sublime_plugin.EventListener的类
便携版用户特别注意：Data 文件夹不是可选配置
便携版的插件路径不是靠设置改出来的，而是由 Data 文件夹的存在自动触发的。这个文件夹必须：
- 与
sublime_text.exe在同一级目录 - 名字严格为
Data（首字母大写，无空格、无扩展名） - 不能藏在子目录里（比如
SublimeText/Data是无效的）
一旦建错，Sublime 就退回到系统路径（如 %APPDATA%\Sublime Text\Packages），你在便携目录里做的所有插件操作都无效。验证方式只有一个：菜单 Preferences → Browse Packages… 显示的路径必须是 你的解压路径\Data\Packages，否则重来。
