根本原因是packagecontrol.io域名在2026年国内不可达,导致Package Control无法获取channel_v3.json;应改用Gitee镜像源并彻底重启,或手动执行官方安装命令验证哈希值后重启。

Sublime安装插件时提示“Unable to download package”或卡在Loading状态,根本不是你手速慢、没点对菜单,而是Package Control在后台反复尝试连接https://packagecontrol.io/channel_v3.json这个地址却始终得不到响应——该域名在2026年国内绝大多数网络环境下已完全不可达,请求直接超时或被拦截,连TLS握手都失败。
确认是不是源的问题
别凭感觉猜,打开浏览器,把当前配置里的channels地址完整粘贴进去,敲回车。
如果页面返回一整页JSON(开头是{"packages": [),说明链路通了;如果空白、404、跳转到Gitee登录页、或报TLS handshake timeout,就立刻换源。
常见失效链接包括:【https://php.cn/xxx(2026年全404)】、【https://raw.githubusercontent.com/(被墙)】、漏掉/raw/master/路径段。
改用Gitee镜像源(最稳解法)
方法一:填对位置+用对URL+彻底重启,三者缺一不可
① 菜单栏 → Preferences → Package Settings → Package Control → Settings – User
② 在右侧编辑区填入以下内容(注意双引号、逗号、括号必须严格匹配):
{"channels": ["https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"]}
③ 保存后必须彻底退出Sublime:macOS右键Dock图标→Quit;Windows进任务管理器杀掉所有subl.exe;Linux执行pkill -f sublime。不重启=白改。
手动安装Package Control(当自动安装脚本根本跑不起来时)
方法1:控制台执行官方单行命令(推荐)
按Ctrl + `调出控制台,粘贴并回车运行:
import urllib.request,os,hashlib; h = '6f4c264a24d237259395a6f7a7eb1a8e' + '6c5b3b5e'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); by = urllib.request.urlopen('https://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download: %s' % dh if dh != h else 'Success'); open(os.path.join(ipp, pf), 'wb').write(by)
看到Success才表示写入成功,此时关闭再重启Sublime,Package Control菜单才会出现。
方法2:检查系统时间是否准确——误差超过5分钟会导致SSL证书验证失败,控制台报ssl.CertificateError,但界面无任何提示。
排查两个隐蔽干扰项
即使源地址正确,仍可能静默失败:
① 检查系统hosts文件是否写了错误的packagecontrol.io或scs-1.packagecontrol.io IP映射,哪怕你已换源,GPG签名校验阶段仍会硬连这些域名。
② 杀毒软件(火绒、360、腾讯电脑管家)会静默劫持urllib请求,控制台无报错,但请求根本没发出去。临时禁用杀软后重试。

















