Package Control卡在“Installing 1 package”是因packagecontrol.io国内访问受限导致索引下载超时静默失败,最稳解法是手动下载.sublime-package文件放入Packages/目录(非Installed Packages/),并确保路径、命名准确且彻底重启Sublime。

Package Control 卡在 “Installing 1 package” 怎么办
这不是插件本身的问题,而是 packagecontrol.io 在国内访问受限导致超时静默失败。控制台不报错、不提示、只转圈,本质是索引下载和插件分发链路被阻断。
- 别等它自己恢复——该域名 2026 年仍普遍限速或 DNS 不稳
- 别信“换网络就好”,手机热点、校园网、企业防火墙都可能触发相同行为
- 最稳解法是绕过在线通道:直接下载
.sublime-package文件丢进Packages/目录(不是Installed Packages/) - 优先去插件 GitHub 的
Releases页面找带.sublime-package后缀的附件(如SideBarEnhancements.sublime-package),比 ZIP 更可靠
手动安装后插件不生效的三个硬性条件
路径、命名、重启三者缺一不可,任一环节出错 Sublime 就当没这回事——且完全不报错。
-
Packages/路径必须准确:Windows 是%APPDATA%\Sublime Text 3\Packages\,macOS 是~/Library/Application Support/Sublime Text 3/Packages/,Linux 是~/.config/sublime-text-3/Packages/ -
.sublime-package文件必须放在Packages/根目录,不能放子文件夹,也不能重命名(名字必须和 Release 页面一致) - 必须彻底退出 Sublime:Windows 检查任务栏进程是否残留,macOS 右键 Dock 图标选 Quit,不是关窗口
为什么配了代理还是卡住
Sublime 不继承系统代理,且对代理配置格式极其敏感,写错一个字符就失效。
-
"http_proxy": "http://127.0.0.1:7890"和"https_proxy": "http://127.0.0.1:7890"—— 协议必须是http://,哪怕目标是 HTTPS 站点 - 端口必须和本地代理监听端口完全一致(Clash 默认
7890,但部分配置用7891或8080) - 不能含认证信息,如
user:pass@,Sublime 的urllib不支持 - 配完别急着装插件,先在控制台运行:
import urllib.request; urllib.request.urlopen('https://packagecontrol.io').getcode(),返回200才算真正通了
镜像源配置最容易漏掉的关键细节
换 Gitee 镜像源看似简单,但 URL 错一个字符就会静默失败——Sublime 不提示、不报错、不加载,只当 channel 不存在。
- 必须用含
/raw/master/路径的地址,例如:"https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json" - 结尾必须是
/channel_v3.json,少一个斜杠或拼错字母都会导致索引加载失败 - 配置位置是:
Preferences → Package Settings → Package Control → Settings – User,粘贴进"channels"数组里 - 改完必须彻底退出并重启,否则旧缓存仍在,新源不会生效
ssl.CertificateError,这是所有网络相关问题的第一排查项——校准时间再折腾其他。


















