必须将GitHub插件解压后重命名并放入Browse Packages…打开的真实Packages目录顶层。先通过Preferences → Browse Packages…定位Packages/路径，再用控制台命令sublime.packages_path()确认；解压后剔除-master等外层文件夹，重命名为无空格无点号的干净名称（如BracketHighlighter），直接拖入Packages根目录（非User或Default子目录），确保含.py主模块且定义sublime_plugin类，最后彻底重启Sublime验证命令面板和Package Settings中是否生效。
你需要在没有网络或无法使用Package Control的情况下，把GitHub上下载的插件真正装进Sublime并让它正常运行——不是解压完拖进去就完事，90%的失败都卡在目录错、层级多、名字乱这三步上。
确认插件存放的真实目录
别抄网上搜来的路径，Windows/macOS/Linux/便携版/Snap版的Packages位置全不同，ST3和ST4的父目录名也不一样（比如ST4默认是sublime-text，不是sublime-text-4）。
打开Sublime → Preferences → Browse Packages…，文件管理器弹出的那个文件夹就是【Packages/】目录。
关掉这个窗口，往上退一级，找到名为【Installed Packages/】的文件夹——它只用来放.sublime-package压缩包，插件文件夹绝不能丢这儿。
不确定？按Ctrl+`调出控制台，输入：
import sublime; sublime.packages_path()
import sublime; sublime.installed_packages_path()
回车后两行路径就是你机器上真实有效的地址，以它为准。
下载并解压GitHub插件源码
访问插件GitHub主页 → 点Code → Download ZIP，不要用git clone（除非你明确需要分支或历史记录）。
解压后，你会看到类似PluginName-main或PluginName-master这样的外层文件夹——这是GitHub自动生成的包装壳，Sublime根本不会读里面的内容。
必须进到这层文件夹里，把真正含__init__.py或主模块文件（如git_gutter.py）的子文件夹单独拎出来。
重命名为干净名称：首字母大写、无空格、无中文、无点号、无-master后缀，例如把BracketHighlighter-master改成BracketHighlighter。
放入正确目录并验证结构
把重命名后的整个文件夹，直接拖进刚才通过Browse Packages…打开的【Packages/】目录顶层。
不能放进Packages/User/，不能放进Packages/Default/，也不能嵌套在任何子文件夹里——必须平级放在Packages根下。
打开该文件夹，检查至少有一个.py文件，且其中定义了继承自sublime_plugin.TextCommand或sublime_plugin.EventListener的类，否则Sublime加载时会静默跳过。
重启并确认生效
彻底退出Sublime：Windows右键任务栏图标→退出，macOS用Cmd+Q，Linux检查进程是否残留（ps aux | grep sublime），不杀干净会导致插件缓存未刷新。
重新启动Sublime，按Ctrl+Shift+P呼出命令面板，输入插件名关键词，看是否出现对应命令。
如果插件带菜单项，检查Preferences → Package Settings里有没有它的设置入口。
