Package Control加载失败主因是控制台脚本执行中断或文件放错路径;需验证状态栏提示、改用官网动态脚本、将.sublime-package文件放入Installed Packages/目录,并检查ignored_packages配置。

Package Control 加载失败,不是插件没装好,而是它根本没启动成功——90% 的情况是控制台脚本执行卡在 TLS 握手或证书验证,或者手动放错了 Package Control.sublime-package 文件位置。
Package Control 控制台安装失败:别等,先看状态栏和控制台
执行官方 Python 脚本后,只看左下角状态栏是否出现 Package Control: Successfully installed Package Control。如果几秒后只有 reloading plugin 或完全无反应,说明安装中断了。
- 常见原因:
URLError(DNS 或代理不通)、CertificateError(系统 OpenSSL 过旧或企业防火墙拦截 TLS 1.3)、ssl.SSLCertVerificationError(macOS 上尤其多) - 别用旧网页上带
st3或st4字样的脚本——2026 年所有 ST4 稳定版必须用动态生成的https://packagecontrol.io/installation.py脚本 - 执行完别急着关控制台,等满 5 秒再判断;若超时,直接切手动安装,不折腾代理或 hosts
手动安装 Package Control:文件必须进 Installed Packages/,且不能解压
这是最常踩的坑:把 Package Control.sublime-package 丢进 Packages/ 目录,Sublime 会彻底无视它。
- 正确路径:菜单 →
Preferences → Browse Packages…→ 向上退一级 → 进入Installed Packages/目录 - 下载地址必须是官网原始链接:
https://packagecontrol.io/Package%20Control.sublime-package(注意空格是 %20) - 拖入后,删掉该目录下所有含
Package Control字样的旧文件(比如Package Control.sublime-package.bak),避免冲突 - 重启 Sublime 后,按
Ctrl+Shift+P输入Package Control: List Packages——能弹出空列表才算真生效
插件手动安装不生效:先确认路径、命名、ignored_packages 三件事
手动装完插件,命令面板搜不到、菜单不出现,大概率不是代码问题,而是被 Sublime 主动跳过了。
- 路径必须是
Packages/根目录(不是Installed Packages/,也不是Packages/User/子目录) - 文件夹名要干净:比如下载的是
BracketHighlighter-master.zip,解压后重命名为BracketHighlighter,再整个拖进Packages/ - 打开
Preferences → Settings – User,检查"ignored_packages"数组里有没有刚装的插件名(如"BracketHighlighter"),有就删掉 - 重启前务必彻底退出 Sublime(macOS 注意右键 Dock 图标选
Quit,Windows 检查任务栏后台进程)
PyV8 类插件(如 Emmet、CSScomb)报错:不是网络问题,是依赖断链
控制台反复出现 Unable to download package 或 ImportError: No module named PyV8,说明插件依赖的二进制模块缺失,和代理无关。
- Sublime Text 4 已移除 PyV8 支持,升级 ST4 是最干净解法;若必须用 ST3,就得手动补全
- 去 Gitee 镜像站搜
pyv8-win64-p3(Win)、pyv8-macos-universal(macOS)或pyv8-linux-x86_64(Linux) - 解压后,把全部内容(含
__init__.py和pyv8.pyd/pyv8.so)塞进Packages/PyV8/——注意文件夹名必须是PyV8(首字母大写,不能小写或全小写) - 重启后打开控制台观察是否有
reloading plugin PyV8日志,没有则说明路径或大小写错了
真正卡住人的从来不是“怎么装”,而是装完后 Sublime 偷偷忽略你放进去的东西——ignored_packages 配置、大小写敏感的路径、Installed Packages/ 和 Packages/ 的混淆,这三处不核对清楚,重装十次也没用。











