Package Control 请求失败时应先验证底层网络通道是否通畅，而非直接重试或换源；需手动测试 channel_v3.json 可访问性，排查代理配置、证书信任及超时设置，并清理残留的 .part 文件确保安装环境干净。
Package Control 请求失败时，先看 channel_v3.json 能否手动下载
插件安装卡在 “Installing…” 或直接报错 Unable to download package list，第一反应不该是重试或换源，而是验证底层通道是否通。Package Control 启动时会先请求 https://packagecontrol.io/channel_v3.json，这个文件是所有插件元数据的总索引。如果浏览器里打不开它，说明网络层已阻断；能打开但 Sublime 里失败，大概率是代理或证书验证问题。
实操建议：
- 用 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—— 此时才是干净状态
