根本原因是 packagecontrol.io 域名在国内无法稳定解析或连接超时,导致获取 channel_v3.json 时 HTTP 请求挂起;需修改 Package Control.sublime-settings 中 channels 为清华等可用镜像地址,并排查 hosts、防火墙、TLS 兼容性等问题。

为什么 Package Control 安装插件卡在 Loading?
根本原因通常是默认的 https://packagecontrol.io/ 域名在国内无法稳定解析或连接超时,导致 Package Control 插件在获取仓库列表(channel_v3.json)时一直阻塞。这不是 Sublime 自身问题,而是网络链路中断——你看到的 “Loading…” 实际是 HTTP 请求挂起,不是插件坏了。
如何修改 Package Control 的源地址(channel)?
必须直接修改 Package Control.sublime-settings 配置文件中的 channels 数组,指向国内可用镜像。注意:不能只改 http_timeout 或重装插件,核心是换 channel URL。
- 菜单栏打开 Preferences → Package Settings → Package Control → Settings
- 在右侧用户设置中,将
channels替换为以下任一可用镜像地址(推荐清华源):
{
"channels": [
"https://mirrors.tuna.tsinghua.edu.cn/packagecontrol/channel_v3.json"
]
}
保存后重启 Sublime,再打开 Command Palette(Ctrl+Shift+P)→ Package Control: Install Package,加载速度应明显改善。
哪些镜像地址目前可用且稳定?
不同镜像的更新延迟和 HTTPS 证书有效性差异较大,实测有效的是:
-
https://mirrors.tuna.tsinghua.edu.cn/packagecontrol/channel_v3.json(清华,推荐,响应快、同步及时) -
https://ghproxy.com/https://github.com/wbond/package_control_channel/raw/master/channel_v3.json(GitHub 代理中转,需确保代理可用) - 避免使用已失效的旧镜像,例如
https://web.archive.org/web/20220000000000*/https://packagecontrol.io/channel_v3.json这类 Wayback Machine 地址,内容过期且不支持最新插件签名验证
修改后仍 Loading 的常见遗漏点
换源只是第一步,还需排查这些实际干扰项:
- 系统 hosts 文件是否误屏蔽了
packagecontrol.io或其 CDN 域名(如scs-1.packagecontrol.io),即使换了 channel,PC 仍可能尝试校验旧域名 - 杀毒软件或防火墙拦截了 Sublime 的 HTTPS 请求(尤其某些国产安全软件会静默劫持 TLS 流量)
- Sublime Text 4 用户需确认已升级到 Build 4143+,老版本对 TLS 1.3 和现代证书链兼容性差,会导致 JSON 下载失败但不报错,只卡 Loading
- 不要在
Package Control.sublime-settings中同时保留多个 channel URL,PC 会按顺序逐个尝试,某个不可达就会拖慢整体响应
真正卡住的时候,先看 Console(Ctrl+`)里有没有 error 或 timeout 关键字,比反复点 Install Package 更能定位问题根源。










