超时问题根源在于 packagecontrol.io 及其 channel_v3.json 所在 GitHub raw CDN 国内无法稳定访问，仅改 hosts 无效；必须将 Settings – User 中 channels 改为 Gitee 镜像地址并重启，或单独配置 http_proxy。
直接结论：超时不是 Sublime 问题，是 packagecontrol.io 和 channel_v3.json 地址在国内无法稳定直连。必须改 channels 配置项为国内镜像源，仅改 hosts 或只配代理常不够。
为什么改 hosts 不足以解决 “There are no packages available”
改 hosts（如绑定 104.20.151.17 packagecontrol.io）只能让 packagecontrol.io 域名解析和首层连接变快，但 Package Control 实际加载插件列表时，依赖的是 channels 里指定的 channel_v3.json 文件——这个文件默认托管在 GitHub raw CDN（raw.githubusercontent.com），而该域名在国内基本不可靠。
常见错误现象：
– Sublime 能成功安装 Package Control（菜单出现）
– 但执行 Package Control: Install Package 后弹出空列表或提示 “There are no packages available”
– 控制台无报错，或只显示 “Failed to download channel”
- 必须修改
Preferences → Package Settings → Package Control → Settings – User中的channels字段，指向 Gitee 镜像的channel_v3.jsonURL - 不能用已失效旧链接（如某些博客里的
php.cn或channel.json路径，ST4 及新版 ST3 仅认channel_v3.json） - 推荐使用当前仍活跃维护的镜像：
"https://gitee.com/kuoruan/sublime-package-control/raw/master/channel_v3.json"（截至 2026 年 4 月实测可访问）
Settings – User 里怎么写 channels 才有效
打开 Preferences → Package Settings → Package Control → Settings – User，填入标准 JSON 格式。注意三点：路径必须完整、结尾必须带 .json、数组不能漏中括号。
正确示例：
{
"channels": [
"https://gitee.com/kuoruan/sublime-package-control/raw/master/channel_v3.json"
]
}
- 不要写成
"channel.json"或"channel"—— 这类地址 2026 年已全部返回 404 - 不要加多余字段如
http_proxy在同一配置里混用；如果同时设了代理，channels仍应指向镜像源，否则可能因代理不稳定导致间歇性失败 - 保存后务必重启 Sublime，或执行
Package Control: Synchronize Repositories强制刷新缓存
代理配置和镜像源能共存吗
可以，但不推荐混用。如果你已有 Clash/V2Ray 等工具，且监听端口是 127.0.0.1:7890，更稳妥的做法是：清空 channels，只设代理，让 Package Control 回归直连逻辑，靠代理穿透访问原始地址。
此时 Settings – User 应为：
{
"http_proxy": "http://127.0.0.1:7890",
"https_proxy": "http://127.0.0.1:7890"
}
- Sublime 的 urllib 不支持带认证的代理字符串（如
user:pass@），会直接报错 - 协议必须统一用
http://，哪怕目标是 HTTPS 站点；https_proxy写成https://会导致连接失败 - 设完后建议在控制台运行：
import urllib.request; urllib.request.urlopen('https://packagecontrol.io').getcode()，返回200才算真正通
手动安装 Package Control 失败时的兜底动作
自动安装脚本卡在第一步（URLError 或空白响应），说明网络连 packagecontrol.io 首包都拿不到。这时跳过脚本，走纯本地安装：
- 关闭 Sublime Text（macOS 注意菜单栏「退出」，不只是关窗）
- 删除残留：
Installed Packages/Package Control.sublime-package和Packages/Package Control/整个文件夹 - 下载最新
Package Control.sublime-package文件（官网 Manual Installation 页面提供直链） - 把该文件拖进
Packages/目录（可通过Preferences → Browse Packages…打开） - 重启后立即进
Settings – User配好channels，再试安装插件
最容易被忽略的是：即使换了镜像源，若之前失败过多次，Packages/Package Control/ 下可能残留损坏的缓存目录，不删干净，新配置不会生效。
