sublime text 的 package control 代理配置需用 http:// 格式、开启 http 代理监听、正确设置环境变量并重启软件,同时推荐使用 gitee 镜像源解决 channel_v3.json 获取失败问题。

Sublime Text 的 Package Control 默认不走系统代理,填错格式、漏重启、防火墙拦截这三类问题占了 90% 的“连不上”报错。
Package Control 代理必须用 http:// 格式,socks5:// 和 https:// 都会静默失效
Clash、V2RayN、Surge 这些工具默认开两个端口:SOCKS5(如 127.0.0.1:1080)和 HTTP(如 127.0.0.1:7890)。Package Control 只认后者。
-
http_proxy和https_proxy的值必须是http://host:port,不能写成https://或省略协议 - 如果代理工具没开「Allow LAN」或「HTTP 代理监听」,
curl -v http://127.0.0.1:7890会返回connection refused,这时填进去也没用 - 带认证的代理需对用户名/密码做 URL 编码,比如
user@domain要写成user%40domain - 不需要认证就别填
proxy_username和proxy_password字段,留空或干脆不写
配置改完必须重启 Sublime,热重载不生效
Preferences → Package Settings → Package Control → Settings – User 里改完 JSON,保存后 Ctrl+Q 关掉所有窗口,再重新打开——否则控制台日志里看不到 via http://127.0.0.1:7890 这类提示,说明配置根本没加载。
- 检查 JSON 语法:字段名和字符串必须用英文双引号,最后一项后面不能有多余逗号
- 控制台执行
Package Control: Install Package后,看输出里是否出现downloading https://packagecontrol.io/ via ...,没有就等于没走代理 - Windows 用户特别注意:防火墙常默认阻止
sublime_text.exe出站,要进「允许应用通过防火墙」手动勾选「专用」和「公用」网络
连 channel_v3.json 都拿不到?先换镜像源,别急着调代理
很多用户填了代理还是看到 “There are no packages available”,其实不是代理没通,而是默认源 https://packagecontrol.io/channel_v3.json 在 DNS 或 TLS 层就被阻断了。这时候调代理是白费劲。
- 在 Settings – User 里加这一行:
"channels": ["https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"] - 这个 Gitee 镜像是当前最稳定的国内源(截至 2026 年 6 月),不用代理也能加载
- 改完必须重启 Sublime,缓存不会自动刷新;如果还卡住,可以先执行
Package Control: Clear Package Control Cache再重启 - 别用已失效的旧镜像链接(比如某些博客里写的 php.cn 或 126 镜像),2026 年多数已返回 404
真正难搞的不是配代理,而是杀软静默劫持 HTTPS 请求、组策略禁止出站、或者系统时间偏差超 5 分钟导致 SSL 校验失败——这些不会报明显错误,只会让控制台一直卡住或输出空白。











