Package Control 报错“Unable to download package”或卡在Installing,根本原因是其不读系统代理,必须手动在Settings–User中配置http_proxy和https_proxy为HTTP代理地址(如"http://127.0.0.1:7890"),且需重启Sublime Text生效;SOCKS5不支持,须用HTTP模式;channels加载失败可换国内镜像;SSL报错优先校准系统时间并更新cacert.pem证书。

Package Control 报 “Unable to download package” 或卡在 Installing?先看代理有没有走对
Sublime Text 的 Package Control 完全不读系统代理(哪怕你开了 Clash、设置了 Windows 代理或 macOS 网络偏好),它只认自己配置里的 http_proxy 和 https_proxy。所以即使浏览器能翻,Sublime 仍会连不上——这不是网络问题,是配置没生效。
- 打开
Preferences → Package Settings → Package Control → Settings – User - 填入正确的 HTTP 代理地址,例如:
"http_proxy": "http://127.0.0.1:7890"、"https_proxy": "http://127.0.0.1:7890"(注意:必须是http://开头,https://会静默失效) - Clash 默认 HTTP 端口是
7890,V2RayN/SSR 常用10808;SOCKS5 地址如127.0.0.1:1080不支持,得换 HTTP 模式或启用工具的 HTTP 转发 - 代理不需要认证就别填
proxy_username和proxy_password,留空即可
控制台里看不到 “via http://127.0.0.1:7890”?说明代理根本没被用上
按 Ctrl + ` 打开控制台,执行一次 Package Control: Install Package,观察输出。如果看到的是 downloading https://packagecontrol.io/... 而没有 via ...,说明配置没加载成功,或者 JSON 格式错了(比如末尾多逗号、引号用中文、括号不匹配)。
- 确认配置文件是纯 JSON:不能有注释,字段名和字符串必须双引号,最后一项后不能有逗号
- 保存后**必须重启 Sublime Text**,热重载不生效
- 检查代理进程是否在运行,且允许本地连接(Clash 需开启 “Allow LAN”)
- Windows 下防火墙可能拦截
sublime_text.exe出站请求,在“允许应用通过防火墙”中手动勾选它
装完插件列表还是空白,或提示 “there are no packages available”
这通常是通道地址(channels)加载失败,而不是插件本身的问题。默认的 https://packagecontrol.io/channel_v3.json 在部分网络下 DNS 解析失败或被干扰。
- 进入
Package Control → Settings – User,添加或修改channels字段: -
"channels": ["https://gitee.com/akira-cn/package_control_channel/raw/master/channel.json"](国内可用镜像,无需代理) - 路径必须是完整 URL,不能写成本地文件路径(如
D:\\xxx\\channel.json),除非你已下载并确保路径绝对正确、无中文、无空格 - 删掉旧的
channels条目再试,避免多个地址冲突
SSL 报错 “CERTIFICATE_VERIFY_FAILED” 怎么办
这不是代理配置错误,而是证书校验失败——常见于企业 HTTPS 解密代理、过期系统时间、或 Sublime 内置证书太老。临时关校验能绕过,但不解决根源。
- 先检查系统时间是否准确(差几分钟都可能触发该错)
- 不推荐长期设
"ssl_verification": false,风险高 - 真正修复方式是更新内置证书:
Packages/Package Control/certifi/cacert.pem替换为最新版(从 certifi 官方或可信源下载) - 路径不对?用
Preferences → Browse Packages…进去手动找,ST4 多数在Packages/Package Control/certifi/下;找不到就新建Packages/User/Package Control.sublime-settings并确保"ssl_verification": true
最常被忽略的一点:代理端口开着,但 Sublime 没权限连出去——尤其在公司电脑上,组策略或终端防护软件会静默拦截,这时候看控制台日志只有 Connection refused,却查不到原因。先试手机热点,排除环境干扰,比反复改配置更省时间。










