package control 安装失败最常见原因是脚本未实际执行,主因是 sublime 版本与脚本不匹配或网络拦截导致 urllib 请求静默超时;需确认使用 st4(≥4126)及对应官方脚本,通过 ctrl+` 粘贴执行,并排查 ssl 证书、缓存及镜像源问题。

Package Control 安装脚本执行后没反应
最常见的情况是复制粘贴的 Python 脚本压根没在 Sublime Text 里运行成功,表面看控制台弹出来了,但实际没执行。根本原因通常是 Sublime 版本和脚本不匹配,或者网络被拦截导致 urllib 请求超时静默失败。
- 确认你用的是 Sublime Text 4(Build ≥ 4126):旧版 ST3 的安装脚本在新版里会卡住,反过来也一样;ST4 必须用官方最新脚本(
https://packagecontrol.io/installation页面顶部标“Sublime Text 4”的那段) - 别直接双击运行脚本文件——必须进 Sublime,按
Ctrl+`(反引号)调出控制台,把整段脚本粘贴进去,回车执行 - 如果控制台只闪一下就消失,说明脚本启动失败;此时手动输入
import urllib.request回车,看是否报错ModuleNotFoundError: No module named 'urllib.request'—— 这代表你误用了 ST3 脚本
控制台报错 ssl.SSLCertVerificationError
这是 macOS 或某些 Windows 环境下证书验证失败,尤其常见于公司网络、教育网或开了代理但没配置好 SSL 的情况。不是插件问题,是 Python 内置的 urllib 拒绝连接 packagecontrol.io 的 HTTPS 端点。
- 临时绕过(仅调试用):在控制台执行前,先运行
import ssl; ssl._create_default_https_context = ssl._create_unverified_context,再粘贴安装脚本 - 更稳妥的做法是配系统级证书:macOS 打开“钥匙串访问”,搜索 “packagecontrol.io”,右键导出为
packagecontrol.crt,然后在 Sublime 控制台中执行import certifi; print(certifi.where()),把证书追加进那个路径下的cacert.pem文件 - 不要长期禁用 SSL 验证,否则后续插件更新也会失败
安装完 Package Control,按 Cmd+Shift+P 没反应
看起来装好了,但命令面板打不开,大概率是 Package Control 没真正加载,或者被其他插件阻塞。它不像普通插件那样出现在 Packages/ 目录下,而是以 Package Control.sublime-package 形式存在,靠 Sublime 自动解压加载。
- 检查
Packages/目录下有没有Package Control文件夹:没有?说明安装未完成;有但为空?说明解压失败,删掉整个Package Control.sublime-package(在Installed Packages/目录),重装 - 关掉所有第三方插件(尤其是那些修改命令面板行为的,比如
Origami、AdvancedNewFile),再重启 Sublime 测试 - Windows 用户注意:杀毒软件有时会拦截
Package Control.sublime-package的写入,临时关闭实时防护再试
装完插件列表空白,或 Package Control: Install Package 无响应
这通常不是安装失败,而是 Channel 文件加载超时或损坏。Package Control 默认从 https://packagecontrol.io/channel_v3.json 拉取插件索引,国内直连极慢甚至超时,结果就是命令能触发,但列表永远转圈。
- 手动换镜像源:打开
Preferences → Package Settings → Package Control → Settings,在右边 JSON 中添加:"channels": ["https://ghproxy.com/https://packagecontrol.io/channel_v3.json"] - 别用“国内加速站”类非官方源,很多已失效或签名不一致,会导致
Package Control: Upgrade Package报校验错误 - 删掉
Packages/User/Package Control.cache/下全部文件,强制刷新缓存
真正卡住的地方往往不在“怎么装”,而在于你没意识到 Sublime 的插件加载机制依赖网络、证书、缓存三者同时就位。哪怕只有一项不对,它就不会报错,只是沉默——这也是很多人反复重装却无效的原因。











