错误。.sublime-package文件必须放入installed packages目录，而非packages目录；放入packages会导致sublime完全忽略，无法加载。
手动安装 .sublime-package 文件
直接把 .sublime-package 文件扔进 Packages 目录就行，不用解压——Sublime Text 会自动识别并加载它。
-
.sublime-package本质是 ZIP 压缩包，但 Sublime 有专用加载器，解压反而会导致失效 - 必须放进
Packages目录（不是Installed Packages），路径以Preferences → Browse Packages…打开的实际位置为准 - Linux/macOS 下注意文件权限：
chmod 644 *.sublime-package，否则可能静默跳过加载 - 放完后需完全退出 Sublime 再重启，仅重载插件（
sublime_plugin.reload_plugin()）对.sublime-package无效
GitHub 下载的 ZIP 怎么处理才对
GitHub 点 “Download ZIP” 得到的压缩包，90% 情况下多一层 plugin-name-main 或 plugin-name-master 目录，这是干扰项，不能直接拖进去。
- 解压后进入那层多余目录，找到真正含
__init__.py或plugin_name.py的子文件夹 - 把这个子文件夹整体重命名为规范名称，例如
GitGutter（首字母大写、无空格、无中文、无点号、无-master后缀） - 整个文件夹拖进
Packages顶层，不能嵌套在User/或其他子目录里 - 检查该文件夹内至少有一个
.py文件，且定义了继承自sublime_plugin.TextCommand等的类，否则控制台会报reloading plugin XXX failed
为什么插件放对了却没反应
最常见原因是路径或结构不合规，Sublime 根本没扫描到，而不是“安装失败”。
- 误把插件放进
Installed Packages目录：那里只认.sublime-package文件，放文件夹会被忽略 - 插件目录名含空格或点号（如
Bracket Highlighter或Emmet.2），Sublime 会跳过加载 - 依赖缺失，比如 Emmet 依赖
PyV8，但PyV8是二进制模块，需单独放入Installed Packages/并确保架构匹配（x64/ARM64） - ST4 默认路径是
~/.config/sublime-text/Packages/，不是sublime-text-4；便携版路径更不同，别靠记忆硬写
验证和调试的关键动作
别只看菜单有没有新项，得用控制台确认真实加载状态。
- 按
Ctrl+`调出控制台，启动时若看到reloading plugin YourPluginName行，说明已识别 - 如果出现
ImportError，说明缺依赖或路径错；SyntaxError表示 Python 版本不兼容（ST4 用 Python 3.8，ST3 是 3.3） - 执行
import sublime; sublime.packages_path()和sublime.installed_packages_path()查实时路径，比网上搜的“默认路径”可靠得多 - 命令面板（
Ctrl+Shift+P）搜插件名，能列出命令说明基本就绪；搜不到就回去查目录和命名
