Package Control 连不上主因是 channel_v3.json 加载失败,需确认 Sublime 版本选对应安装脚本、替换为可用 Gitee 镜像地址、配置 http_proxy 代理、手动验证镜像 URL 可访问并重启编辑器。

Package Control 连不上,90% 不是插件坏了,而是 channel_v3.json 根本没加载成功——它卡在 DNS、SSL 或代理链路上,不是重装就能解决的。
确认 Sublime 版本再选安装脚本
ST3 和 ST4 的安装脚本不兼容,混用必报 NameError: name 'urllib2' is not defined 或静默失败。
- 按
Ctrl + `打开控制台,运行print(sublime.version()) - 返回
4xxx→ 必须用官网 https://packagecontrol.io/installation 页面顶部标“Sublime Text 4”的脚本(含urllib.request和hashlib.sha256) - 返回
3xxx→ 用 ST3 专用脚本,哈希值必须与当前官网一致(如h = '7183a2d3e96f11eeadd761d777e62404'),旧博客抄的大概率已失效 - 粘贴前检查:无中文引号、无换行、无不可见 Unicode 字符;执行后右下角出现
Package Control: Installing dependencies才算真正开始
替换 channels 地址为可用 Gitee 镜像
装上 Package Control ≠ 能装插件。“There are no packages available” 是最典型的假成功,本质是 channels 仍指向无法访问的 https://packagecontrol.io/channel_v3.json。
- 进
Preferences → Package Settings → Package Control → Settings – User - 填入完整 JSON(注意双引号、无注释、末尾无逗号):
{ "channels": [ "https://gitee.com/akira-cn/package_control_channel/raw/master/channel_v3.json" ] } - 浏览器直接打开该 URL,必须返回一整页 JSON 内容才算有效;用
/channel.json或 php.cn 等旧链接会白配 - 保存后必须重启 Sublime —— 设置不热重载,不重启等于没改
Clash/Surge 用户必须手动配置 http_proxy
Sublime 的 urllib.request 不继承系统代理,开了 Clash 也等于没开。
- 在
Settings – User中加两行:"http_proxy": "http://127.0.0.1:7890",<br>"https_proxy": "http://127.0.0.1:7890"
- 协议必须是
http://,哪怕目标是 HTTPS 站点;写成https://会静默失效 - 端口必须和你 Clash 实际监听端口一致(常见还有
7891、1080、6152) - 不要加认证字段(如
user:pass@),Sublime 的 urllib 不支持带认证的代理字符串
验证 channel_v3.json 是否真能访问
这是最容易被跳过的一步:所有配置做完后,一定要手动验证镜像地址是否可访问,否则前面全白忙。
- 把
channels数组里的 URL 粘到浏览器地址栏,回车 - 必须返回合法 JSON(开头是
{,内容含"packages"字段),不能是空白页、超时、404 或 Gitee 限流提示 - 如果打不开,换另一个镜像,比如:
https://gitee.com/mirrors/package_control_channel/raw/master/channel_v3.json - 别信“能打开 packagecontrol.io 就代表通了”——
raw.githubusercontent.com和packagecontrol.io是两个独立域名,都得通
真正卡住的地方,往往不是“怎么装”,而是“装完之后谁来告诉它去哪找插件”。channels 配错、没重启、镜像 URL 缺 /raw/master/、代理端口写错——这四类问题占了实际故障的 80% 以上。

















