.sublime-package文件必须放入installed packages目录，放错路径（如packages/）将导致sublime完全忽略；需用print(sublime.installed_packages_path())确认真实路径，且不可解压、改名或嵌套。
.sublime-package 文件必须丢进 Installed Packages 目录
装不上不是 Sublime 有问题，是文件放错了地方。Package Control.sublime-package、Emmet.sublime-package 这类文件，Sublime 只认 Installed Packages/ 目录，扔进 Packages/ 就等于没放——它连扫描都不会扫。
关键动作：
- 用
Preferences → Browse Packages…打开的是Packages/，它的上一级才是Installed Packages/ - 不确定路径？控制台执行
print(sublime.installed_packages_path())，直接看到真实路径 - ST4 用户尤其注意：旧版安装脚本会静默失败，必须删干净所有含
Package Control字样的文件，再放入官方镜像下载的Package Control.sublime-package（大小应在 180–220 KB） - 别解压、别改名、别嵌套子目录——拖进去就完事
GitHub 下载的 ZIP 插件要重命名后整个扔进 Packages 根目录
从 GitHub 点 Download ZIP 得到的压缩包，解压后默认是 Emmet-master/ 或 ConvertToUTF8-main/ ——这层后缀是 GitHub 自动生成的壳，Sublime 不识别。
正确操作：
- 进到解压后的文件夹里，把真正含
__init__.py或主模块（如emmet.py）的那层文件夹单独拎出来 - 重命名为插件官方名：
Emmet-master/→Emmet/，Origami-dev/→Origami/，大小写必须完全一致，不能带空格或下划线 - 整个文件夹拖进
Packages/根目录（不是子文件夹），确保里面至少有一个.py文件且定义了sublime_plugin.TextCommand类
插件“装了但不生效”大概率被 ignored_packages 静默屏蔽
命令面板搜不到、快捷键没反应、菜单不出现——90% 是因为你在用户设置里写了 "ignored_packages": ["Emmet"]，Sublime 就真当它不存在，也不报错。
排查步骤：
- 打开
Preferences → Settings，看右侧用户配置中是否有ignored_packages字段 - 如果刚装的插件名（比如
"Origami"）在列表里，删掉或整行注释，保存后必须彻底退出 Sublime 再重启 - 插件还可能只在特定语法下激活：比如 Vue Syntax Highlight 只响应
.vue文件或作用域text.html.vue；打开.html文件时右下角显示HTML，它就沉默 - 按
Ctrl+Shift+P输入Set Syntax:切换语法试试
PyV8 等老插件报 ImportError 不是网络问题，是依赖缺失
装 Emmet、CSScomb 时控制台反复报 ImportError: No module named 'PyV8'，不是代理或证书问题——PyV8 官方源已归档，Package Control 拿不到地址。
手动补全方案：
- 去 Gitee 镜像站下载对应系统的包，例如
pyv8-win64-p3.zip（Win64 + Python 3） - 解压后，把所有内容（含
__init__.py和pyv8.pyd或pyv8.so）直接塞进Packages/PyV8/文件夹 - 注意：文件夹名必须是
PyV8（首字母大写），小写或拼错就加载失败 - 离线更新插件时，必须先彻底退出 Sublime，删掉旧插件文件夹或
.sublime-package，再放新版本——缓存不清理，旧代码还在内存里
ignored_packages 也从不报错，只让插件彻底消失。
