插件文件应根据格式分别放入packages或installed packages目录：.sublime-package文件必须直接放入installed packages/，不可解压；github下载的zip解压后需移除冗余外层文件夹，将含init.py的文件夹重命名为首字母大写无特殊字符的名称并放入packages/顶层。
插件文件该放 Packages 还是 Installed Packages？
Sublime Text 严格区分这两个目录，放错就等于没装。.sublime-package 文件（比如 Emmet.sublime-package）必须直接拖进 Installed Packages/ 目录，不许解压、不许改名、不许嵌套子文件夹。
GitHub 下载的 ZIP 解压后得到的文件夹（含 <strong>init</strong>.py 或主模块文件），必须整体放进 Packages/ 目录顶层——不是 Packages/User/，也不是 Packages/Default/。
- 用菜单
Preferences → Browse Packages…打开的路径就是Packages/ - 它的上一级目录里那个叫
Installed Packages/的文件夹，才是.sublime-package的唯一合法位置 - 不确定？在控制台执行
print(sublime.packages_path())和print(sublime.installed_packages_path())，路径秒出
GitHub ZIP 解压后怎么重命名才有效？
GitHub “Download ZIP” 得到的压缩包，解压后几乎必然多出一层 plugin-name-main 或 plugin-name-master。这层是 GitHub 自动生成的包装壳，Sublime 加载时会跳过它，导致静默失败。
- 进入那层冗余文件夹，把真正含
<strong>init</strong>.py或主模块（如git_gutter.py）的子文件夹单独拎出来 - 重命名为干净名称：首字母大写、无空格、无中文、无点号、无
-master后缀（例如GitGutter，不是gitgutter也不是GitGutter-master） - 检查重命名后的文件夹内至少有一个
.py文件，且其中定义了继承自sublime_plugin.TextCommand或sublime_plugin.EventListener的类 - 大小写敏感：插件名
EmacsProMode放成emacspromode就不会加载
插件放对了但命令面板搜不到？先查 ignored_packages
90% 的“安装成功但不生效”问题，其实不是路径错了，而是被 Sublime 主动忽略了。
- 打开
Preferences → Settings，看右侧用户配置中是否有"ignored_packages"字段 - 如果刚放进去的插件名（比如
"Emmet"）出现在这个列表里，它就被静默禁用了 - 删掉对应项，或临时注释整行，保存后重启验证
- 另外注意语法作用域：有些插件只在特定文件类型下触发（比如
Vue Syntax Highlight只响应.vue文件或text.html.vue作用域），打开纯.html文件时不会激活
重启不彻底，插件就不加载
Sublime 不会在运行时扫描 Packages/ 新增目录，旧模块还可能驻留在内存里。
- 关闭 Sublime Text 前，确认所有窗口都已关闭（包括后台进程，Windows 可查任务管理器，macOS 可用 Activity Monitor）
- 更新插件时，必须先删旧再放新：进
Packages/删除整个旧文件夹，或进Installed Packages/删除旧的.sublime-package文件 - 放入新版本后，务必重启——不是热重载，不是 Cmd+R，是完全退出再启动
- 启动后按
Ctrl+`调出控制台，观察有无reloading plugin XXX或ImportError日志，这是唯一可信的加载证据
路径、命名、忽略列表、重启方式，四者缺一不可。漏掉任意一个，插件就只是硬盘上的文件夹而已。
