Sublime Text手动安装插件必须将解压后的文件夹放入Packages/目录，.sublime-package文件则须放入Installed Packages/目录；放错位置会导致插件被静默忽略，重启后控制台报错或功能不生效。
插件文件该扔进哪个目录
Sublime Text 会忽略你放错位置的插件——Installed Packages/ 和 Packages/ 是两个完全独立、互不扫描的目录。手动安装插件，必须把解压后的文件夹放进 Packages/；而 .sublime-package 文件（比如 Package Control.sublime-package）只能扔进 Installed Packages/。
别靠猜路径：打开菜单 Preferences → Browse Packages…，弹出的就是 Packages/ 的真实路径；它的上一级目录里那个叫 Installed Packages/ 的才是另一个地方。Windows/macOS/Linux 路径不同，但结构一致。
-
Packages/：放解压后的插件文件夹（如Emmet/、Origami/），里面至少得有__init__.py或主.py文件 -
Installed Packages/：只放官方发布的.sublime-package文件，不能解压、不能改名、不能套子目录 - 两者混放会导致加载冲突，重启后控制台报
reloading plugin XXX failed或直接静默失效
GitHub ZIP 解压后怎么清理多余层级
从 GitHub 点 “Download ZIP” 得到的压缩包，解压后通常多出一层 plugin-name-main 或 plugin-name-master 目录。这层是 GitHub 自动生成的包装壳，Sublime 不认它——它会找不到入口模块，加载失败。
正确做法是：进到那层多余目录里，把真正含 __init__.py 的子文件夹拎出来，重命名为干净名字（如 BracketHighlighter），然后整体拖进 Packages/ 根目录。
- 文件夹名必须和插件官方注册名完全一致，大小写敏感（
EmacsProMode≠emacspromode） - 不能含空格、中文、点号（
.）、连字符（-）等特殊字符 - 不确定名字？查
packagecontrol.io页面 URL 或插件仓库里的package-metadata.json
拖完不生效？先查 ignored_packages 和语法作用域
插件文件放对了、重启也做了，但命令面板搜不到、快捷键没反应——大概率被 Sublime 主动忽略了。
打开 Preferences → Settings，看右侧用户配置里有没有 "ignored_packages" 字段。如果刚装的插件名（比如 "Emmet"）正好在列表里，它就被静默禁用了。删掉那一项，保存，重启。
- 有些插件只在特定语法下触发：比如
Vue Syntax Highlight只响应.vue文件或text.html.vue作用域；在纯.html文件里不会激活 - 不确定当前作用域？按
Ctrl+Shift+P输入View Package File，选Settings – Syntax Specific查当前语法定义 - 插件依赖其他模块（如
requests）？Sublime 自带 Python 环境有限，这类插件基本无法运行，得换无依赖版本或放弃
Package Control 自己也得手动装对位置
很多人以为“控制台执行脚本成功”就等于 Package Control 装好了，其实不是。ST4 下旧脚本会静默失败，哪怕控制台打印 Package Control installed，也可能只是旧版残留提示，实际没加载。
验证唯一标准：Ctrl+Shift+P 输入 Package Control: List Packages，能弹出列表（哪怕为空）才算真生效。否则就得手动重装：
- 先关掉 Sublime Text，杀掉所有后台进程（macOS 用 Activity Monitor，Windows 任务管理器）
- 进
Installed Packages/，删光所有含Package Control字样的文件（包括备份） - 去 https://www.php.cn/link/2e5d5f65d3ef778b01366907d1f14445 下载（注意 URL 中空格是
%20） - 把下载好的
Package Control.sublime-package文件（180–220 KB）直接拖进Installed Packages/，不要解压、不要改名
最常被跳过的一步：拖完必须彻底退出再启动，否则 Sublime 不会重新扫描 Installed Packages/ 目录。
