最可靠方法是通过preferences → browse packages…打开packages目录，其上一级的installed packages目录放.sublime-package文件；github下载的zip需解压并移除-master等冗余层级，重命名为规范名称后整体放入packages顶层。
插件放错目录，Sublime 就当它不存在——90% 的“安装没反应”问题都卡在这一步。
怎么找对 Packages 和 Installed Packages 目录？
别猜路径，也别复制网上搜来的默认路径。Windows/macOS/Linux/便携版/Snap 版的路径都可能不同，ST3 和 ST4 的目录名还不一样（比如 ST4 默认是 sublime-text，不是 sublime-text-4）。
- 最可靠方法：菜单栏
Preferences → Browse Packages…，点一下就打开文件管理器，这个窗口里的位置就是Packages/目录 - 它的上一级目录里那个叫
Installed Packages/的文件夹，才是放.sublime-package文件的地方 - 不确定？按
Ctrl+`调出控制台，输入import sublime; sublime.packages_path()和sublime.installed_packages_path()，回车直接看真实路径
GitHub 下载的 ZIP 插件怎么解压才对？
GitHub 点 “Download ZIP” 得到的压缩包，解压后通常多出一层 plugin-name-main 或 plugin-name-master 文件夹。这层是 GitHub 自动生成的包装壳，Sublime 不会识别它里面的 .py 文件。
- 进到那层文件夹里，把真正含
__init__.py或主模块文件（如git_gutter.py）的子文件夹单独拎出来 - 重命名为干净名称，例如
GitGutter（首字母大写、无空格、无中文、无点号、无-master后缀） - 整个文件夹拖进
Packages/顶层，不能嵌套在其他子文件夹里（比如不能放进Packages/User/或Packages/Default/） - 检查该文件夹内至少有一个
.py文件，且其中定义了继承自sublime_plugin.TextCommand或sublime_plugin.EventListener的类
为什么重启后插件还是不出现？
Sublime 不会在运行时扫描新增文件夹，而且后台进程常驻会导致旧代码残留。只关窗口或按 Ctrl+R 是不够的。
- macOS：右键 Dock 图标 →
Quit（不是关窗口），再检查活动监视器里是否还有subl进程 - Windows：任务管理器 → 结束所有
subl.exe进程（注意区分 ST3/ST4 的多个实例） - Linux：终端执行
pkill -f "subl"或先ps aux | grep subl再kill -9对应 PID - 重启后立刻按
Ctrl+Shift+P，输入插件名看命令是否出现；没反应就打开控制台（Ctrl+`），看有没有reloading plugin XXX failed或ImportError
插件放对了但命令面板搜不到？
大概率被 Sublime 主动忽略了，而不是没装上。
- 打开
Preferences → Settings，看右侧用户配置中是否有"ignored_packages"字段；如果刚放进去的插件名（比如"Emmet"）也在这个列表里，它就被静默禁用了 - 插件只在特定语法下触发——比如
Vue Syntax Highlight只响应.vue文件或text.html.vue作用域；打开纯.html文件时完全静默 - 某些老插件（如
Emmet、CSScomb）依赖已归档的PyV8，控制台报ImportError: No module named 'PyV8'时，需手动补全：去 Gitee 镜像站下载对应系统的包，解压后把所有内容塞进Packages/PyV8/（注意文件夹名必须是PyV8，首字母大写）
最容易被忽略的是路径层级和命名一致性：Sublime 不会提示“放错位置”，它只是沉默地跳过；ignored_packages 列表也从不报错，只让插件彻底消失。验证是否生效，唯一可信的方式是重启后看控制台日志，而不是仅凭菜单或快捷键有无反应。
