手动安装github插件需“剥壳”并放对路径：解压后删除plugin-name-master等外层目录，将含__init__.py的子文件夹重命名为规范名（如emmet），直接拖入packages/根目录；.sublime-package文件则须放入installed packages/目录。
手动解包未上架插件，核心就两件事：解压路径必须对、文件夹命名必须准——放错一级目录或名字带 -master，Sublime 就当它不存在。
解压 GitHub ZIP 后多了一层目录，怎么“剥壳”？
GitHub 点 Code → Download ZIP 得到的压缩包，解压后几乎必然多出一层 plugin-name-master 或 plugin-name-main。这层是 GitHub 自动生成的包装壳，Sublime 不会扫描它里面的 .py 文件。
- 进到那层目录里，找到真正含
__init__.py或主模块（如emmet.py、git_gutter.py）的子文件夹 - 把这个子文件夹单独剪出来，重命名为规范名：首字母大写、无空格、无中文、无点号、无
-master后缀（例如把Emmet-master改成Emmet） - 确保该文件夹内至少有一个
.py文件，且定义了继承自sublime_plugin.TextCommand或sublime_plugin.EventListener的类
.sublime-package 文件该扔进哪个目录？
.sublime-package 是个 ZIP 压缩包，Sublime 会在启动时自动解压加载——但它只认 Installed Packages/ 目录，放错地方等于没放。
- 用菜单
Preferences → Browse Packages…打开的是Packages/目录 - 它的上一级目录里的
Installed Packages/才是.sublime-package的唯一合法位置 - 不要解压它，不要改名，不要嵌套子目录；直接拖进去，重启生效
- 不确定路径？按
Ctrl+`调出控制台，运行import sublime; sublime.installed_packages_path()看真实路径
插件放对了却没反应，为什么命令面板搜不到？
最隐蔽的问题不是路径错，而是被 ignored_packages 静默屏蔽了——Sublime 不报错，也不提示，只是彻底跳过加载。
- 打开
Preferences → Settings，看右侧用户配置中是否有"ignored_packages"字段 - 如果刚装的插件名（如
"Origami"、"ChineseLocalization"）出现在这个列表里，它就被禁用了 - 删掉对应项，或整行加
//注释，保存后必须完全退出 Sublime 再重启 - 注意：
ignored_packages只影响 Package Control 安装的插件，对Packages/下的原生插件（如Vintage）无效
依赖缺失（比如 PyV8 报错）怎么办？
老插件如 Emmet、CSScomb 启动时报 ImportError: No module named 'PyV8'，不是网络问题，是二进制依赖没补全。
- 去 Gitee 镜像站下载对应系统的包（如
pyv8-win64-p3.zip），解压后得到__init__.py和pyv8.pyd（Windows）或pyv8.so（macOS/Linux） - 在
Packages/目录下新建文件夹，名字必须严格为PyV8（首字母大写，不能小写） - 把所有解压出的文件直接塞进
Packages/PyV8/，不要嵌套子目录 - Sublime Text 4 已移除 PyV8 支持，若必须用这类插件，建议降级到 ST3 或换替代方案
最容易被忽略的是：Sublime 不会告诉你“路径错了”，它只是沉默跳过；ignored_packages 列表也从不报错，只让插件彻底消失。动手前先确认当前版本（sublime.version()），ST4 对文件夹命名和模块结构校验更严，旧版插件可能根本加载不了。
