package control插件安装卡在loading或报urlerror/timeouterror,根本原因是无法访问默认源https://packagecontrol.io/channel_v3.json;需验证网络连通性、校准系统时间、禁用杀软、更换gitee或清华镜像源(路径须准确)、配置http代理或手动安装插件并彻底重启sublime。

Package Control 插件安装卡在 Loading、报 URLError 或 TimeoutError,基本可以确定是它连不上默认源 https://packagecontrol.io/channel_v3.json——不是你网速慢,是这个地址在国内多数网络环境下根本无法完成 TLS 握手或 DNS 解析。
验证是不是网络层彻底断开
别猜,直接用 Sublime 自带的 Python 环境测通路:
按 Ctrl+` 打开控制台,粘贴执行:
import urllib.request; urllib.request.urlopen('https://httpbin.org/get', timeout=5).read()
如果几秒没反应、报 URLError 或 TimeoutError,说明 Sublime 根本发不出 HTTPS 请求;如果报 ssl.SSLError,大概率是系统时间不准(误差超 5 分钟)或杀毒软件劫持了 TLS 流量。
- Sublime 不走系统代理,也不读
HTTP_PROXY环境变量,开全局代理对它无效 - Windows 上的 360、腾讯电脑管家、火绒常静默拦截
urllib.request的 HTTPS 请求,临时禁用再试 - 浏览器能打开不等于 Sublime 能连——它用的是独立的 Python SSL 上下文
换国内镜像源必须做对三件事
改 channels 是最直接有效的解法,但 2026 年实测有效的地址极少,且格式容错极低:
- 只用这一条 Gitee 镜像(2026 年持续可用):
"https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json" - 清华源也可用,但路径必须严格为:
"https://mirrors.tuna.tsinghua.edu.cn/packagecontrol/channel_v3.json"(注意是/packagecontrol/,不是/package-control/) - 填进
Preferences → Package Settings → Package Control → Settings – User,确保 JSON 合法:双引号包裹、无尾逗号、数组用方括号 - 改完必须彻底退出 Sublime:macOS 右键 Dock 图标选 Quit;Windows 进任务管理器杀掉所有
sublime_text.exe进程
为什么换源后还是卡在 Loading?两个隐蔽点常被忽略
哪怕镜像 URL 正确、浏览器能打开 JSON,仍可能静默失败:
-
hosts文件里写了错误的packagecontrol.io或scs-1.packagecontrol.ioIP —— Package Control 在 GPG 签名校验阶段仍会尝试直连这些域名,和channels设置无关 - 杀毒软件(尤其火绒、360)会静默劫持请求,控制台无报错,但实际请求根本没发出;可临时关闭后重试
- 别信“别人说好用”的旧博客链接:2026 年
php.cn类镜像全 404,raw.githubusercontent.com直链被墙,漏掉/raw/master/就返回 HTML 页面而非 JSON
手动安装插件是兜底方案
当换源 + 关杀软 + 校准时间都无效时,跳过 Package Control 自动流程:
- 访问
https://packagecontrol.io或 Gitee 镜像站搜索插件名,下载.sublime-package文件或 ZIP 包 - 解压 ZIP 后,整个文件夹放入
Packages/目录(不是嵌套子目录);.sublime-package文件直接丢进Installed Packages/ - 路径位置(以 ST4 为例):
Windows:%APPDATA%\Sublime Text\Packages\
macOS:~/Library/Application Support/Sublime Text/Packages/
Linux:~/.config/sublime-text/Packages/ - 重启 Sublime 后,插件即生效;依赖类插件(如
mdpopups)需一并手动装上
sublime_text.exe 或 subl 进程没彻底退出,一切修改都不生效。











