package control插件安装卡住、转圈或报urlerror/timeouterror，根本原因是无法访问默认源https://packagecontrol.io/channel_v3.json，需验证网络连通性、校准系统时间、禁用杀软、更换清华或gitee镜像源（格式必须正确）、配置http代理（端口匹配），或手动下载插件放入packages目录并彻底重启sublime。
Package Control 安装插件卡住、转圈、报 URLError 或 TimeoutError，基本不是插件本身的问题，而是它连不上默认源 https://packagecontrol.io/channel_v3.json——这个请求在 DNS 解析、TLS 握手或 CDN 回源阶段就失败了。
验证是不是网络层卡住
按 Ctrl+` 打开控制台，粘贴执行：
import urllib.request; urllib.request.urlopen('https://httpbin.org/get', timeout=5).read()
如果几秒没反应、报 URLError 或 TimeoutError，说明 Sublime 根本没连上外网；如果报 ssl.SSLError，大概率是系统时间不准或 TLS 协议不兼容。
- 系统时间误差超过 5 分钟会导致证书校验失败，先校准时间
- Sublime 不走系统代理，也不读
HTTP_PROXY环境变量，开全局代理对它无效 - 杀毒软件（尤其 Windows 上的 360、腾讯电脑管家）会静默拦截
urllib.request的 HTTPS 请求，临时禁用试试
换国内镜像源是最直接有效的解法
清华源和 Gitee 镜像目前最稳，但必须用对地址格式，否则 Sublime 会静默跳过：
- 打开
Preferences → Package Settings → Package Control → Settings – User - 把
"channels"改成单个 HTTPS 地址，结尾必须是/channel_v3.json，例如："channels": [ "https://mirrors.tuna.tsinghua.edu.cn/packagecontrol/channel_v3.json" ]
- 不能用
http://开头的源（Sublime Text 4 默认禁用非 HTTPS 源） - Gitee 镜像必须含
/raw/master/路径，比如：https://gitee.com/kuoruan/sublime-package-control/raw/master/channel_v3.json - 改完必须彻底重启 Sublime（macOS 注意 Dock 右键 Quit，Windows 检查任务栏进程是否残留）
代理配置要写对端口和协议
有 Clash/V2Ray 等本地代理时，得显式告诉 Sublime，但它只认 http:// 格式的代理地址，不支持认证和 HTTPS 代理：
- 在
Package Control → Settings – User中加两行："http_proxy": "http://127.0.0.1:7890", "https_proxy": "http://127.0.0.1:7890"
- 端口必须和你本地代理监听端口一致（Clash 默认
7890，部分配置可能是7891或1080） - 别写成
https://或带用户名密码，Sublime 的urllib不支持 - 设完后，先在控制台运行
import urllib.request; urllib.request.urlopen('https://packagecontrol.io').getcode()验证是否返回200
手动安装插件是终极保底方案
当换源+代理都不可靠时，绕过 Package Control 在线流程，直接放文件进目录：
- 去插件 GitHub 主页（如
https://github.com/jisaacks/GitGutter），点Code → Download ZIP，不要git clone - 解压后重命名文件夹为纯英文（如
GitGutter-master→GitGutter），去掉空格、中文、点号 - 打开
Preferences → Browse Packages…，把文件夹拖进弹出的目录（不是Installed Packages！） - 关闭并彻底退出 Sublime（Windows 检查任务栏进程，macOS 右键 Dock 图标选 Quit），再重开
- 更省事：找插件 Releases 页面里带
.sublime-package后缀的文件，直接丢进Packages目录根下，重启自动解压启用
最容易被忽略的是重启动作——不彻底退出，Sublime 会复用旧的 Python 运行时，插件即使放对路径也不会加载。
