Sublime插件必须按类型放入对应目录：.sublime-package文件直接丢进Installed Packages/，不解压；GitHub下载的ZIP解压后重命名规范文件夹（如Emmet）并整体拖入Packages/根目录，不能嵌套。
插件文件该扔进 Packages 还是 Installed Packages？
Sublime 只从 Packages 目录加载源码插件（即含 .py 文件的文件夹），而 Installed Packages 专用于 .sublime-package 压缩包——放错就等于没装。
- 下载的是
Emmet.sublime-package→ 直接丢进Installed Packages/，不要解压，重启生效 - 下载的是 GitHub ZIP（如
BracketHighlighter-main.zip）→ 解压后取最内层含<strong>init</strong>.py或主模块（如bracket_highlighter.py）的文件夹，重命名（如BracketHighlighter），整 folder 拖进Packages/顶层 - 绝对不能嵌套：比如
Packages/User/BracketHighlighter/或Packages/Default/xxx/，Sublime 不会扫描子目录
用菜单打开最可靠：Preferences → Browse Packages…，弹出的窗口路径就是 Packages/；它的上一级目录里那个叫 Installed Packages/ 的才是另一个位置。
GitHub ZIP 解压后多了一层 master/main 怎么办？
GitHub “Download ZIP” 自动生成的包装壳（如 PluginName-master/ 或 PluginName-main/）不是插件本体，Sublime 加载时会跳过，控制台常报 reloading plugin XXX failed 或完全静默。
- 解压 ZIP 后，先进入那层多余文件夹（如
GitGutter-master/） - 找到真正含插件逻辑的子文件夹（通常有
<strong>init</strong>.py、git_gutter.py或同名.py文件） - 把它单独剪切出来，重命名为规范名称：首字母大写、无空格、无中文、无点号、无
-master后缀（例如GitGutter） - 检查重命名后的文件夹里至少有一个
.py文件，且其中定义了继承自sublime_plugin.TextCommand或sublime_plugin.EventListener的类
名字不规范（比如 git-gutter 或 git gutter）会导致 Sublime 跳过导入，不报错也不加载。
插件放对了却没反应？先查 ignored_packages
命令面板搜不到、快捷键失效、菜单不出现——大概率被 Sublime 主动忽略了，不是代码问题。
- 按
Ctrl+Shift+P输入Preferences: Settings打开用户配置 - 看右侧 JSON 中是否有
"ignored_packages"字段 - 如果刚安装的插件名（如
"Emmet"、"ConvertToUTF8"）出现在这个数组里，它就被静默禁用 - 删掉对应项，或临时注释整行，保存后必须重启 Sublime（只关窗口不够，得彻底退出进程）
注意大小写：插件文件夹名是 SideBarEnhancements，但 ignored_packages 里写成 "sidebarenhancements" 也会被忽略。
重启后控制台报 PyV8 或 ImportError 怎么办？
老插件（如 Emmet、CSScomb）依赖 PyV8，但 ST4 已移除支持，ST3 也常因二进制缺失失败。
- 报
ImportError: No module named 'PyV8'或反复提示Unable to download package→ 不是网络问题，是依赖链断了 - 若用 ST3：去 Gitee 镜像站下载对应系统+Python 版本的包（如
pyv8-win64-p3.zip），解压后把所有内容（含<strong>init</strong>.py和pyv8.pyd）塞进Packages/PyV8/（注意文件夹名必须是PyV8，首字母大写） - 若用 ST4：直接放弃依赖
PyV8的旧插件，换用现代替代品（如 Emmet 官方已提供 ST4 原生版）
离线更新插件时，别覆盖：先删旧文件夹或 .sublime-package，再放新版本，否则旧模块可能仍驻留内存。
