Sublime Text 的 Package Control 不走系统代理,需在设置中手动配置 http_proxy 和 https_proxy 为 HTTP 代理地址(如 http://127.0.0.1:7890),不支持 SOCKS5;验证需查看控制台日志,注意防火墙、组策略及杀软拦截。

Sublime Text 的代理设置不走系统全局代理
Sublime Text 默认不会读取系统代理(比如 Windows 的 Internet 选项或 macOS 的网络设置),插件管理器 Package Control 也完全独立处理 HTTP 请求,所以即使你开了 Clash、Proxyman 或设置了系统代理,Package Control 仍可能报错 Unable to download package 或卡在 “Installing” 状态。
在 Package Control 设置中手动配置 http_proxy / https_proxy
打开 Preferences → Package Settings → Package Control → Settings – User,在右侧 JSON 中添加以下字段(注意逗号位置):
{
"http_proxy": "http://127.0.0.1:7890",
"https_proxy": "http://127.0.0.1:7890",
"proxy_username": "",
"proxy_password": ""
}
常见情况说明:
- Clash、V2RayN、Surge 等工具默认监听
127.0.0.1:7890(HTTP 模式),填这个地址即可;若用的是 SOCKS5(如127.0.0.1:1080),Package Control不支持,必须换为 HTTP 代理端口或启用工具的 HTTP 转发功能 - 如果代理需要认证,才填写
proxy_username和proxy_password;多数本地代理无需认证,留空即可 - 不要写成
https://开头——http_proxy字段值必须是http://host:port格式,否则会静默失效
验证代理是否生效:看 Package Control 控制台日志
按 Ctrl+`(反引号)打开 Sublime 控制台,执行一次插件安装(比如 Package Control: Install Package → 输入 Emmet),观察输出:
- 成功时能看到类似
downloading https://packagecontrol.io/... via http://127.0.0.1:7890 - 失败时若仍显示
connection timeout或Connection refused,说明代理地址错误、端口未监听,或防火墙拦截了 Sublime 的出站请求 - 如果提示
SSL: CERTIFICATE_VERIFY_FAILED,不是代理问题,而是证书校验失败,可临时加"ssl_verify": false(不推荐长期使用)
Windows 下 Sublime 可能被组策略/防火墙拦截
尤其在公司内网或教育网环境中,即使代理配置正确,Sublime 也可能被 Windows Defender 防火墙或组策略禁止联网。这时需确认:
- 在 Windows 防火墙「允许应用通过防火墙」列表中,勾选
sublime_text.exe的「专用」和「公用」网络权限 - 检查是否启用了「强制代理」或「PAC 脚本」策略,这类策略通常绕过用户手动配置的代理,需联系 IT 部门确认 Sublime 是否在白名单中
- 某些杀毒软件(如 360、腾讯电脑管家)会劫持 HTTPS 流量并替换证书,导致
Package ControlSSL 握手失败;临时退出这类软件再试
代理本身只是链路一环,真正卡住的往往是本地网络策略对 Sublime 进程的限制——这点最容易被忽略。










