Emmet安装失败主因是PyV8依赖已停更且下载链断裂；ST4已弃用PyV8，升级可彻底解决；ST3用户需手动安装匹配系统与Python版本的PyV8二进制包，或改用无依赖的Emmet 2替代方案。
Sublime Text 插件安装失败，尤其是像 Emmet 这类依赖 PyV8 的插件，真正卡住的往往不是主插件本身，而是它背后那个早已停止维护、又必须联网下载的二进制依赖包——PyV8。这不是配置问题，是生态断链；手动装好插件后仍报 unable to download PyV8，说明你正撞上这个经典“伪网络问题”。
为什么 Emmet 安装总卡在 PyV8 下载失败？
PyV8 是 Emmet 早期版本（特别是 Sublime Text 3）运行 JavaScript 补全逻辑所必需的嵌入式引擎，但它的官方仓库 emmetio/pyv8-binaries 已归档，且不提供 HTTPS 直链下载入口。Package Control 尝试用 urllib 或 curl 请求时，常因证书校验失败、重定向跳转或域名不可达而静默中断，控制台只显示 Unable to download package，根本看不到真实错误。
- 该问题与你的代理/镜像源无关——即使能顺利装其他插件，
PyV8仍会单独失败 - Sublime Text 4 已弃用
PyV8，改用原生 JS 引擎，所以升级是最彻底解法（但部分老项目仍需 ST3 兼容） - 网上流传的“自动重试”或“清缓存”对
PyV8无效，因为它压根没进 Package Control 的标准分发流程
手动安装 PyV8：路径、命名、系统位数一个都不能错
必须从可信镜像获取预编译二进制包，并严格按 Sublime 的加载规则放置。关键点不在“能不能放”，而在“放得对不对”：
- 下载地址推荐：Gitee 镜像站（持续同步），选对应系统的压缩包，例如：
pyv8-win64-p3.zip（Win64 + Python 3）、pyv8-osx-universal2-p3.zip（macOS Apple Silicon/M1）、pyv8-linux64-p3.zip（Linux x64） - 解压后，**不要保留 ZIP 文件夹结构**，直接把内部所有文件（含
__init__.py、pyv8.so或pyv8.dylib）放进 Sublime 的Installed Packages目录下的PyV8.sublime-package文件（注意：是 `.sublime-package` 后缀，不是文件夹！） - 若你选择用文件夹方式部署（兼容性更强），则必须建名为
PyV8的**纯文件夹**（大小写敏感！不能叫pyv8或PYV8），放在Packages目录下（不是Installed Packages），且内部必须包含__init__.py和平台对应动态库 - macOS 用户特别注意：ST3 默认使用 Python 3.3，但很多镜像包是为 Python 3.8+ 编译的，优先选标有
p3的版本，避免ImportError: dynamic module does not define module export function
绕过 PyV8：用现代替代方案启动 Emmet
如果你只是需要 Emmet 的 HTML/CSS 快速展开能力，而非运行自定义 JS 脚本，完全可跳过 PyV8，改用社区维护的无依赖分支：
- 卸载原版
Emmet（命令面板 →Package Control: Remove Package→ 输入Emmet） - 安装
Emmet 2（GitHub 仓库：sergeche/emmet-sublime v2），它已移除PyV8依赖，纯 Python 实现，支持 ST3/ST4 - 手动安装方式：进入
Packages目录，执行：git clone https://github.com/sergeche/emmet-sublime.git Emmet
（注意文件夹名必须是Emmet，不是emmet-sublime） - 验证是否生效：打开 HTML 文件，输入
div>ul>li*3后按Tab，若正常展开即成功
最易被忽略的一点：Sublime 的 Packages 和 Installed Packages 是两个不同目录，混放会导致插件加载冲突或静默失效；而 PyV8 的二进制文件一旦位数或 Python 版本不匹配，不会报错，只会让 Emmet 功能部分失灵（比如缩写展开正常，但 CSS 属性补全失效）。动手前，先确认你用的是 ST3 还是 ST4，再决定走“打补丁”还是“换内核”。
