sublime text的package control不走系统代理,必须手动配置http_proxy和https_proxy为http://格式、端口匹配本地http代理(如127.0.0.1:7890),并替换channels为国内镜像源(如清华或gitee),三者缺一不可。

Sublime Text 的 Package Control 不走系统代理,填错 http_proxy 或 https_proxy 格式、端口不匹配、没换镜像源,这三件事加起来能覆盖 95% 的插件安装失败场景。
Package Control 的代理字段必须是 http:// 协议
Clash/V2RayN/Surge 开了全局代理也没用——Package Control 底层用的是 Python 的 urllib.request,它不读环境变量、不继承系统设置,只认配置文件里明写的两个字段,且协议必须为 http://,哪怕目标是 HTTPS 站点。
-
http_proxy和https_proxy都要填,值必须严格写成"http://127.0.0.1:7890"这种格式 - 写成
https://127.0.0.1:7890或127.0.0.1:7890(缺协议)会静默失效,控制台无报错也不连 - SOCKS5 地址如
socks5://127.0.0.1:1080完全不支持,必须换到对应工具的 HTTP 监听端口(Clash 默认是 7890,但可能被改成了 7891 或 8080,得自己确认) - 别加末尾斜杠,别用中文引号,别从网页复制带不可见 Unicode 字符的代码
光配代理还不够:channels 必须换国内镜像源
即使代理通了,https://packagecontrol.io/channel_v3.json 在国内也常因 DNS 污染或 CDN 异常返回空响应。Package Control 加载失败,绝大多数卡在这一步。
- 清华源最稳:
"https://mirrors.tuna.tsinghua.edu.cn/packagecontrol/channel_v3.json" - Gitee 镜像需含
/raw/master/路径,例如:"https://gitee.com/kuoruan/sublime-package-control/raw/master/channel_v3.json" - 不能用
http://开头的地址(Sublime Text 4 默认禁用非 HTTPS 源) -
channels是数组,哪怕只写一个地址也要包在方括号里:"channels": ["..."]
验证代理是否真生效,别只看“有没有报错”
按 Ctrl+` 打开控制台,运行这行测试命令:
import urllib.request; urllib.request.urlopen('https://httpbin.org/get', timeout=5).read()
结果分三种情况:
- 返回一串 JSON → 代理通了,问题在
channels或证书校验 -
Connection refused→ 代理进程没开、端口填错、或防火墙拦截了sublime_text.exe出站请求 -
SSL: CERTIFICATE_VERIFY_FAILED→ 不是代理问题,是系统时间误差超 5 分钟,或杀软劫持了 SSL 连接;临时可加"ssl_verify": false,但别长期留着
手动安装比等自动安装更可靠
如果连 Package Control 本体都装不上,说明安装脚本本身也需要走代理。这时靠改设置文件已经晚了。
- 直接浏览器访问
https://packagecontrol.io/Package%20Control.sublime-package下载文件 - 扔进
Installed Packages/目录(不是Packages/) - Windows 路径示例:
%APPDATA%\Sublime Text 3\Installed Packages\ - macOS/Linux 路径示例:
~/Library/Application Support/Sublime Text 3/Installed Packages/(macOS)或~/.config/sublime-text-3/Installed Packages/(Linux) - 重启 Sublime,再检查
Preferences → Package Settings里有没有Package Control项
最容易被忽略的是:改完配置后没彻底重启——macOS 要右键 Dock 图标选 Quit,Windows 要在任务管理器里确认 sublime_text.exe 进程已退出干净。残留进程会继续读旧缓存,让你误以为配置没生效。











