优先更新 package control 至最新版;macos 用户需检查钥匙串中 digicert 或 isrg root x1 根证书是否设为“始终信任”;最后可手动指定 ssl_certificate_file 路径。
Sublime Text 报错 “SSL: CERTIFICATE_VERIFY_FAILED” 怎么办
这是 Sublime Text 3(尤其是旧版或 macOS / Linux 上)安装插件时最典型的证书验证失败错误,根本原因是 Python 内置的 SSL 模块无法校验 Package Control 连接的 https://packagecontrol.io 服务器证书。不是网络问题,也不是插件源挂了,而是本地 OpenSSL 信任链缺失或过期。
- 常见报错全文类似:
error: Package Control: Error downloading package. SSL: CERTIFICATE_VERIFY_FAILED - Windows 用户较少遇到,因 Sublime 自带 Python 常附带较全的 CA 证书;macOS 和某些 Linux 发行版(如 Ubuntu 22.04+)更容易触发
- 别急着关 SSL 验证——那是治标不治本,还可能被中间人攻击
优先尝试:更新 Package Control 到最新版
旧版 Package Control(pc-2.x)硬编码了过期的证书校验逻辑,新版(pc-4.x)已改用系统级证书或自带更新机制。手动更新是最安全、最推荐的第一步。
- 打开 Sublime Text →
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)→ 输入Package Control: Upgrade Package Control并执行 - 如果命令不可见,说明当前未安装或损坏,需手动重装:
View → Show Console,粘贴并回车运行官方安装脚本(注意核对官网https://packagecontrol.io/installation最新代码) - 重启 Sublime Text 后再试安装插件,多数情况就此解决
macOS 用户:检查系统钥匙串是否禁用了根证书
macOS 12+(Monterey)起,系统默认将部分老根证书标记为“永不信任”,而 Sublime 的 Python 会继承系统策略。即使浏览器能打开 packagecontrol.io,Sublime 仍可能拒绝连接。