先验证网络层是否中断：执行import urllib.request; urllib.request.urlopen('https://httpbin.org/get', timeout=5).read()，若报URLError/TimeoutError或卡住，说明Sublime底层HTTPS请求失败；此时应排查杀毒软件拦截、TLS证书问题或代理配置错误，而非直接换源或重装。
Package Control 连不上？先验证是不是网络层断了
别急着换源或重装，先确认 Sublime Text 是否真能发 HTTPS 请求。按 Ctrl+` 调出控制台，执行：
import urllib.request; urllib.request.urlopen('https://httpbin.org/get', timeout=5).read()
如果卡住、报 URLError 或 TimeoutError，说明底层网络不通——不是插件问题，是 Sublime 的 Python 环境根本没连出去。此时浏览器能上，不代表 Sublime 能上，因为它不走系统代理，也不读 HTTP_PROXY 环境变量。
- 杀毒软件（尤其是 Windows 上的 360、腾讯电脑管家）常静默拦截
urllib.request的 HTTPS 请求，临时禁用试试 - 控制台输出里若含
ssl.SSLError，基本是 TLS 版本或证书链问题，不是 DNS 或超时 - 别开全局代理“喂”给 Sublime，它不识别 socks/http 代理，反而容易触发证书校验失败
channel_v3.json 加载失败？换镜像源必须写对路径
插件列表空白 / 一直转圈 / 提示 “no packages available”，90% 是拿不到 channel_v3.json。默认源 https://packagecontrol.io/channel_v3.json 在国内多数地区解析失败或握手超时。
- 编辑
Preferences → Package Settings → Package Control → Settings – User - 把
"channels"改成有效镜像，例如：["https://gitee.com/akira-cn/package_control_channel/raw/master/channel_v3.json"]
- 必须带
/raw/master/路径段，结尾必须是/channel_v3.json，不能漏也不能错写成/channel.json - 保存后必须重启 Sublime Text 才生效；设置不热重载，改完立刻关再开
- 清华源稳定但偶尔有 CDN 缓存延迟，新插件可能晚几小时才出现；Gitee 镜像更新更及时，但高峰时段可能限流
开了 Clash/Surge 却还是连不上？代理配置有硬性格式
Clash 默认监听 127.0.0.1:7890，但 Sublime 不自动继承系统代理，必须显式填对字段和协议。
- 在
Package Control.sublime-settings里加这两行："http_proxy": "http://127.0.0.1:7890",<br>"https_proxy": "http://127.0.0.1:7890"
- 协议必须用
http://，哪怕目标是 HTTPS 站点；不能写https://，也不能带认证（如user:pass@） - 端口要跟你本地代理工具实际监听端口一致——Clash 可能被配成
7891或8080，得自己确认 - 设完别直接试插件，先在控制台跑：
import urllib.request; urllib.request.urlopen('https://packagecontrol.io').getcode()，返回200才算真正通了
手动安装插件失败？文件夹名必须和官方名完全一致
装了插件但命令面板搜不到、快捷键无效，大概率是文件夹命名错了。Package Control 只负责下载解压，Sublime 加载插件靠的是 import 路径匹配。
- 去
https://packagecontrol.io/packages/插件名页面，点 “Source” 进 GitHub 仓库 - 点
Code → Download ZIP，解压后得到类似EmacsProMode-master的文件夹 - 必须重命名为
EmacsProMode（去掉-master，不加任何后缀，大小写敏感） - 复制到
Packages目录下对应路径：Windows 是%APPDATA%\Sublime Text 4\Packages\，macOS 是~/Library/Application Support/Sublime Text 4/Packages/ - 别让
Package Control文件夹和Package Control.sublime-package同时存在，冲突会导致插件加载异常
最麻烦的不是调参，而是错误信息从不告诉你卡在哪一层——它不区分是 DNS 卡住、TCP SYN 丢了，还是服务器 SSH 服务压根没响应。网络链路里任何一个环节出问题，Sublime 都只报一个模糊的 timeout 或空响应。
