Sublime Text插件安装失败提示连接超时_Sublime Text修改源地址方法【方案】

落明吖_9541

发布时间：2026-05-27 10:05:04

809人浏览过

来源于php中文网

原创

Package Control插件安装卡在Loading...或Connection timed out，主因是默认源https://packagecontrol.io/channel_v3.json在国内无法访问，必须手动替换为有效镜像源（如Gitee），并彻底重启Sublime Text。

sublime text插件安装失败提示连接超时_sublime text修改源地址方法【方案】

Sublime Text 插件安装卡在 Loading... 或提示 Connection timed out，基本可以确定是 Package Control 无法连上默认源 https://packagecontrol.io/channel_v3.json —— 不是插件坏了，也不是你操作错了，而是这个地址在国内多数网络环境下 DNS 解析失败、TCP 连接超时或 TLS 握手被干扰。

Package Control 的 channels 地址必须手动改，不能靠重装或调超时参数

很多人试过改 http_timeout、重装 Package Control、清缓存，都没用。因为根本问题不在本地逻辑，而在它启动时硬编码去请求的 channels 列表。这个字段不换，所有后续动作都基于一个永远打不开的 URL。

打开 Preferences → Package Settings → Package Control → Settings – User
确保 JSON 格式合法（无多余逗号、引号闭合、数组用方括号）
只保留一条有效镜像，推荐用 Gitee 源（实测 2026 年仍稳定）："https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"
清华源也可用，但注意路径必须是 /packagecontrol/channel_v3.json，不是 /package-control/ 等拼写变体
改完必须彻底重启 Sublime（macOS 要右键 Dock 图标 Quit，Windows 要确认任务栏进程已退出）

浏览器能打开 channel_v3.json 才算真正有效

别信“别人说好用”，直接把你的 channels 数组里那个 URL 粘到浏览器地址栏敲回车。如果返回的是完整 JSON（开头是 { "packages": [），说明链路通了；如果 404、空白页、证书错误或转到 Gitee 登录页，就立刻换源。

常见失效原因：抄了旧博客里的 php.cn 链接（2026 年全 404）、用了 raw.githubusercontent.com 直链（被墙）、漏了 /raw/master/ 路径段
Gitee 镜像必须带 /raw/master/，否则返回 HTML 页面而非 JSON
清华源若报 TLS 错误，可能是 Sublime Text 版本太老（低于 Build 4143），需升级

hosts + 代理配置容易漏掉的关键点

单改 channels 解决大部分问题，但仍有用户换源后仍卡住。这时要排查两个隐蔽干扰项：

hosts 文件里是否误写了 packagecontrol.io 或 scs-1.packagecontrol.io 的错误 IP？哪怕你已经换源，Package Control 在校验插件签名时仍会尝试连接这些域名
杀毒软件（尤其是火绒、360、腾讯电脑管家）会静默劫持 Sublime 的 HTTPS 请求，导致 JSON 下载一半中断，控制台不报错，只卡 Loading —— 临时禁用这类软件再试
如果你开了 Clash/Surge，Sublime 默认不走系统代理，必须显式加 "http_proxy": "http://127.0.0.1:7890" 到 Package Control 设置里，且删掉 channels 字段，让其回归直连逻辑（靠代理穿透）