Sublime插件安装失败主因是默认源https://packagecontrol.io/channel_v3.json国内不可达，需将channels改为2026年实测有效的Gitee镜像地址（如azl397985856的/raw/master/channel_v3.json），填入Settings–User并彻底重启Sublime生效。
Sublime插件安装失败，八成不是你操作错了，而是 Package Control 根本连不上默认源 https://packagecontrol.io/channel_v3.json——这个地址在 2026 年国内绝大多数网络环境下已不可达。改源是最快、最稳的解法，但必须做对三件事：用对 URL、填对位置、彻底重启。
怎么确认是不是源的问题？
别猜，直接验证。把你的 channels 数组里写的那个 URL 粘到浏览器地址栏，敲回车：
- 如果返回一整页 JSON（开头是
{ "packages": [），说明链路通了 - 如果空白、404、跳转到 Gitee 登录页、或报 TLS 错误，就立刻换源
- 常见失效链接包括：
https://php.cn/xxx（2026 年全 404）、https://raw.githubusercontent.com/...（被墙）、漏掉/raw/master/路径段
该填哪个镜像源？只用这一条
推荐唯一稳定可用的 Gitee 镜像（2026 年实测有效）：
{"channels": ["https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"]}
填进 Preferences → Package Settings → Package Control → Settings – User，注意：
- 必须用双引号包裹 URL，结尾不能有多余逗号
- 清华源路径易错：
/packagecontrol/channel_v3.json不是/package-control/ - 别抄旧博客里的链接，很多 php.cn 或码云旧路径已在 2026 年下线
改完不重启 = 白改
Sublime 不会热加载 channels 配置，缓存仍指向原地址。必须彻底退出再启动：
- macOS：右键 Dock 图标 → Quit（不是关窗口）
- Windows：任务栏右键 → 退出，或进任务管理器杀掉所有
subl.exe进程 - Linux：
pkill -f sublime
重启后按 Ctrl+Shift+P 输入 Package Control: Install Package，看到列表弹出才算真正生效。
为什么有时候换源还卡住？两个隐蔽干扰项
即使源地址正确，仍有两类情况会让安装静默失败：
-
hosts文件里写了错误的packagecontrol.io或scs-1.packagecontrol.ioIP，哪怕你已换源，GPG 签名校验阶段仍会尝试连接这些域名 - 杀毒软件（火绒、360、腾讯电脑管家）会静默劫持
urllib请求，控制台可能无报错，但请求根本没发出去
这两个点容易被忽略，一旦换源后仍卡在 Loading，优先检查它们。
