关于Sublime插件安装的网络调优方法-sublime-PHP中文网

package control 请求失败时应先验证底层网络通道是否通畅，而非直接重试或换源；需手动测试 channel_v3.json 可访问性，排查代理配置、证书信任及超时设置，并清理残留的 .part 文件确保安装环境干净。

关于sublime插件安装的网络调优方法

Package Control 请求失败时，先看 `channel_v3.json` 能否手动下载

插件安装卡在 “Installing…” 或直接报错 Unable to download package list，第一反应不该是重试或换源，而是验证底层通道是否通。Package Control 启动时会先请求 https://packagecontrol.io/channel_v3.json，这个文件是所有插件元数据的总索引。如果浏览器里打不开它，说明网络层已阻断；能打开但 Sublime 里失败，大概率是代理或证书验证问题。

实操建议：

ZeroClaw

一款AI工具，主要用于开源、轻量级 AI Agent 框架，基于 Rust 语言编写，适合需要提升相关任务效率的用户。

下载

用 curl 或 wget 手动抓取：curl -v https://packagecontrol.io/channel_v3.json，观察是否返回 200 和 JSON 内容
若超时或 SSL 错误，说明系统级网络栈（如 macOS 的 Security.framework 或 Windows 的 schannel）拒绝了该域名证书——这不是 Package Control 的 bug，而是本地 TLS 策略收紧所致
不要急着改 Sublime 设置，先确认终端里 curl 是否同样失败；如果终端正常而 Sublime 不行，说明它的 HTTP 后端（wininet / urllib）没继承系统代理或证书信任链

代理配置必须写进 `Package Control.sublime-settings`，而非系统环境变量

Sublime Text 的网络请求不读取 HTTP_PROXY 或 https_proxy 环境变量，它只认自己插件的专属配置项。即使你在终端里设置了全局代理，Package Control 依然走直连，这是常见误解根源。

实操建议：

打开 Preferences → Package Settings → Package Control → Settings – User

填入合法代理格式（注意协议必须明确）：

{
  "http_proxy": "http://127.0.0.1:7890",
  "https_proxy": "http://127.0.0.1:7890",
  "proxy_username": "",
  "proxy_password": ""
}

代理地址不能带 https://，否则会触发 DNS 解析失败；端口必须与本地代理工具（如 Clash、Surge）监听端口一致
若使用认证代理，proxy_username 和 proxy_password 必须明文填写，Base64 编码或 URL 编码均无效

`timeout` 和 `channels` 参数直接影响安装成功率

默认超时仅 30 秒，对高延迟网络（如跨运营商、卫星链路）极易中断；同时，官方 channel 地址硬编码在插件逻辑里，无法通过 UI 修改，只能靠配置覆盖。

实操建议：

在 Package Control.sublime-settings 中追加：

"timeout": 60,
"channels": [
  "https://packagecontrol.io/channel_v3.json",
  "https://ghproxy.com/https://raw.githubusercontent.com/wbond/packagecontrol.io/master/channel_v3.json"
]

timeout 值设为 60 是底线，低于 45 秒在多数国内网络下不稳定
第二个 channels 是 GitHub 镜像地址，必须用 ghproxy.com 这类可信中转，直接填 raw.githubusercontent.com 域名仍会被拦截
不要删除第一个官方地址——Package Control 会按顺序尝试，镜像只是 fallback，不是替代

插件安装中途失败后，`Installed Packages` 目录残留文件必须手动清理

Package Control 安装失败时，常在 Packages/Installed Packages/ 下留下半截 .sublime-package 文件（比如 Emmet.sublime-package.part）。下次再装同名插件，它会优先加载这个损坏包，导致功能异常或报 ImportError: No module named xxx。

实操建议：

关闭 Sublime Text
进入用户数据目录：Packages/User/ 同级的 Installed Packages/（Windows 在 %APPDATA%\Sublime Text\Packages\Installed Packages\，macOS 在 ~/Library/Application Support/Sublime Text/Packages/Installed Packages/）
删除所有以 .part 结尾的文件，以及疑似损坏的 .sublime-package（文件大小小于 10KB 的基本可删）
重启 Sublime，再执行 Package Control: Install Package —— 此时才是干净状态

网络调优不是堆参数，关键在验证路径是否真实可达、代理是否被真正采纳、失败痕迹是否清零。很多“重装 Package Control”操作其实只是碰巧清掉了残留文件，而不是重装本身起了作用。