Sublime插件必须放入Packages目录而非Installed Packages；GitHub下载的ZIP需解压并移除-master等冗余层级，重命名为规范名称后整体拖入Packages根目录，否则Sublime不会加载。
直接把 ZIP 拖进 Installed Packages 目录，插件几乎肯定不会生效——Sublime 根本不扫描那里。
为什么 Installed Packages 不是插件安装目录
Sublime 只加载 Packages 目录下的 Python 文件夹（即含 .py 文件、继承 sublime_plugin.TextCommand 等类的文件夹），而 Installed Packages 是 Package Control 自动解压 .sublime-package 文件后存放的地方。你手动扔进去的 ZIP 或文件夹，Sublime 启动时完全忽略。
- Windows 正确路径：
%APPDATA%\Sublime Text\Packages\（注意不是Sublime Text 3或Sublime Text 4子目录，除非你明确用旧版） - macOS 正确路径：
~/Library/Application Support/Sublime Text/Packages/ - Linux 正确路径：
~/.config/sublime-text/Packages/（ST4 默认用sublime-text，不是sublime-text-3）
务必通过菜单进入：Preferences → Browse Packages…，打开的才是有效路径。
GitHub 下载的 ZIP 必须“剥掉一层壳”
从 GitHub 点 Code → Download ZIP 得到的压缩包，解压后通常多出一层 plugin-name-main 或 plugin-name-master 目录。这层是 GitHub 自动生成的包装壳，不是插件本身。
- 进到那层多余目录里，找到真正含
__init__.py或plugin_name.py的子文件夹 - 把它单独拎出来，重命名为干净名称，例如把
BracketHighlighter-master改成BracketHighlighter - 确保名字不含空格、中文、点号（
.）或特殊符号，否则 Sublime 可能跳过加载 - 检查该文件夹内至少有一个
.py文件，且其中定义了继承自sublime_plugin.TextCommand等的类
安装后没反应？先看控制台报错
重启 Sublime 或手动触发 View → Show Console，观察是否有类似 reloading plugin XXX failed 的错误。
- 常见原因：文件夹名非法（含空格或点号）、
.py文件缺失入口类、Python 语法错误 - 如果完全静默无报错，大概率是插件没被识别——再确认是否放对了
Packages目录，且文件夹结构正确 - 部分插件依赖其他插件或特定 Sublime 版本（如 ST4 要求 Python 3.8+），需查其 README
最常被忽略的其实是第一层目录结构：你解压出来的不是插件，只是插件的“外包装”。剥掉它，重命名，放对位置，才是有效安装的全部动作。别的都只是验证和排错环节。
