手动解压安装插件失败主因是路径、命名或重启错误：.sublime-package文件必须放入Installed Packages/目录，GitHub下载的ZIP解压后需移除-master等冗余层级、重命名为规范名称（如BracketHighlighter），再整体放入Packages/根目录；放对后仍无效须检查ignored_packages配置并彻底退出进程后重启。
手动解压安装插件失败，基本不是代码问题，而是路径、命名或重启方式错了——Sublime 对目录结构和文件名极其敏感，放错一层就彻底不加载。
怎么确认插件该放 Packages 还是 Installed Packages
看文件后缀：带 .sublime-package 的压缩包（如 Emmet.sublime-package）必须扔进 Installed Packages/；从 GitHub 下载的 ZIP 解压后得到的是文件夹（比如 Emmet-master/），就得整个放进 Packages/ 根目录。
别凭感觉拖拽：用菜单 Preferences → Browse Packages… 打开的路径就是 Packages/；它的上一级目录里那个叫 Installed Packages/ 的才是另一个地方。不确定？在控制台运行：print(sublime.packages_path()) 和 print(sublime.installed_packages_path()) 看真实路径。
GitHub ZIP 解压后多了一层目录怎么办
点 Code → Download ZIP 得到的压缩包，解压后几乎总会多出一层 plugin-name-main 或 plugin-name-master。这层是 GitHub 自动生成的“壳”，Sublime 不认它。
- 进到那层目录里，找到真正含
__init__.py或主.py文件的子文件夹 - 把它单独拎出来，重命名为干净名称，例如把
BracketHighlighter-master改成BracketHighlighter - 确保名字不含空格、中文、点号（
.）或特殊符号；大小写必须和插件官方名完全一致 - 检查文件夹内至少有一个
.py文件，且其中定义了继承自sublime_plugin.TextCommand等的类
插件放对了却没反应，先查 ignored_packages
这是最隐蔽的“静默失效”原因：插件明明在 Packages/ 里，命令面板搜不到、快捷键没反应，大概率被 Sublime 主动忽略了。
打开 Preferences → Settings，看右侧用户配置中是否有 "ignored_packages" 字段。如果刚装的插件名（如 "Emmet"、"ChineseLocalization"）出现在这个列表里，它就被禁用了。
删掉对应项，或临时整行加 // 注释掉，保存后重启验证。
重启不彻底等于白忙活
Windows/macOS 下 Sublime 常驻后台进程，只关窗口不算真正退出。旧模块还卡在内存里，新文件放进去也不会生效。
必须彻底退出：Windows 上任务管理器杀掉所有 subl.exe 进程；macOS 上 Activity Monitor 搜索 Sublime Text 并强制退出；Linux 上 pkill -f sublime。
重启后，按 Ctrl+` 打开控制台，观察有无 reloading plugin XXX 或 ImportError 日志——这才是真实加载状态。
