package control不走系统代理,必须在settings–user中手动配置http_proxy和https_proxy字段,值均为http://127.0.0.1:端口(如7890),协议仅支持http://,端口须与本地代理工具http监听端口一致,且保存后需彻底退出并重启sublime text才生效。

Package Control 的代理配置不走系统设置
Sublime Text 的 Package Control 完全不读取系统代理(比如 Windows 的“Internet 选项”或 macOS 的网络设置),哪怕你开了 Clash、Surge 或设置了全局代理,Package Control 仍会直连失败。它用的是自己封装的 urllib,必须显式声明代理地址。
http_proxy 字段必须是 http:// 协议且端口匹配
填错协议或端口是静默失败的主因:
-
http_proxy和https_proxy的值都必须以http://开头,哪怕目标是 HTTPS 站点——填https://会直接忽略 - 端口要和你本地代理工具监听的 HTTP 端口完全一致:Clash 默认是
7890,但部分配置启用了7891;Surge 默认是6152;V2RayN 可能是1080或8080 - 不能带认证信息,例如
http://user:pass@127.0.0.1:7890不被支持,会解析失败
验证代理是否真正生效要看控制台日志
改完设置后别急着装插件,先开控制台(Ctrl+`)运行一次安装操作,观察输出:
- 成功时能看到类似
downloading https://packagecontrol.io/channel_v3.json via http://127.0.0.1:7890 - 失败时若仍显示
Connection refused或timeout,说明代理未监听、端口不对,或被防火墙拦截 - 如果报
ssl.CertificateError,不是代理问题,而是系统时间误差超过 5 分钟导致证书校验失败,先校准时间
SOCKS5 代理必须转成 HTTP 才能用
Package Control 不支持 SOCKS5 协议,像 socks5://127.0.0.1:1080 这类地址无效。解决方法只有两个:
- 在 Clash/Surge/V2RayN 中启用 HTTP 代理端口(Clash 默认已开
7890) - 用
ghproxy.com或 Gitee 镜像源替代直连,绕过代理依赖
最常被忽略的是:改完代理设置后没彻底退出 Sublime(macOS 要右键 Dock 图标选 Quit,Windows 要检查任务栏进程是否残留),导致新配置根本不加载。











