插件手动安装失败主因是路径错误：.sublime-package文件须放入Installed Packages/，解压后的文件夹须整体放入Packages/根目录；若插件仍不生效，优先检查ignored_packages配置是否屏蔽该插件。
插件手动安装失败，90% 是因为文件放错了目录，不是代码写得不对，也不是网络问题。
Sublime Text 的 Packages 和 Installed Packages 是两个完全不同的目录
很多人把 .sublime-package 文件拖进 Packages/，或者把解压后的文件夹扔进 Installed Packages/，结果插件根本不会加载——Sublime 会直接跳过，控制台连报错都没有。
-
.sublime-package文件（比如Emmet.sublime-package）必须放进Installed Packages/，不能解压、不能改名、不能嵌套子目录 - 从 GitHub 下载的 ZIP 解压后得到的文件夹（比如
Emmet-master/），必须整体复制进Packages/根目录，且文件夹名要规范（如Emmet，不能带-master或空格） - 用
Preferences → Browse Packages…打开的路径就是Packages/；它的上一级目录里的Installed Packages/才是另一个位置 - 不确定真实路径？在控制台运行
print(sublime.packages_path())和print(sublime.installed_packages_path())查看
插件放对了但命令面板搜不到？先查 ignored_packages
这是最隐蔽也最常见的“静默失效”原因。插件明明在 Packages/ 里，却像没装一样——大概率被 Sublime 主动忽略了。
- 打开
Preferences → Settings，看右侧用户配置中是否有"ignored_packages"字段 - 如果刚装的插件名（如
"Emmet"、"ChineseLocalization"）出现在这个列表里，它就被禁用了 - 删掉对应项，或临时整行注释掉（加
//前缀），保存后重启验证 - 重启后按
Ctrl+Shift+P输入插件相关命令，看是否能触发
GitHub ZIP 解压后多了一层目录？必须手动“剥壳”
点 Code → Download ZIP 得到的压缩包，解压后通常多出一层 plugin-name-main 或 plugin-name-master。这层是 GitHub 自动生成的包装壳，不是插件本身。
- 进到那层目录里，把真正含
__init__.py或主.py文件的子文件夹单独拎出来 - 重命名为干净名称，例如把
BracketHighlighter-master改成BracketHighlighter - 确保文件夹内至少有一个
.py文件，且其中定义了继承自sublime_plugin.TextCommand等的类 - 不要保留中文、空格、点号（
.）或特殊符号，否则 Sublime 可能跳过加载
重启不彻底 = 白忙活
Windows/macOS 下 Sublime 常驻后台进程，只关窗口不算真正退出。旧插件模块可能还驻留在内存里，新文件放进去也不会生效。
- 关掉所有 Sublime 窗口后，再检查系统托盘或活动监视器，确认
sublime_text进程已终止 - macOS 可用
Activity Monitor搜索；Windows 可用任务管理器查看“后台进程” - 重启后建议打开控制台（
Ctrl+`），观察有无reloading plugin XXX日志，确认加载的是你刚放进去的新版 - 如果看到
ImportError或no module named xxx，说明依赖缺失，不是路径问题
最容易被忽略的其实是目录层级和命名大小写——EmacsProMode 和 emacspromode 在 Sublime 看来是两个插件，前者能加载，后者直接无视。
