直接验证是否连通packagecontrol.io：执行import urllib.request; urllib.request.urlopen('https://httpbin.org/get', timeout=5).read()，超时或URLError说明网络断开，ssl.SSLError则多因系统时间不准或杀软劫持；换Gitee镜像源须含/raw/master/路径且结尾为/channel_v3.json；手动安装插件必须放入Packages/目录而非Installed Packages/，并彻底退出Sublime后重启；杀软和hosts文件是高频干扰源，需优先排查。
确认是不是 packagecontrol.io 连不上
别猜，直接验证。按 Ctrl+` 打开控制台，粘贴执行：import urllib.request; urllib.request.urlopen('https://httpbin.org/get', timeout=5).read()
几秒没反应、报 URLError 或 TimeoutError，就是网络层彻底断了；如果报 ssl.SSLError，大概率是系统时间不准（误差超 5 分钟）或杀软劫持 HTTPS 请求。
换 Gitee 镜像源必须带 /raw/master/ 路径
清华源和 Gitee 都能用，但 Gitee 更稳——前提是 URL 完全正确。打开 Preferences → Package Settings → Package Control → Settings – User，填入：
{"channels": ["https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"]}
注意三点：
- 结尾必须是
/channel_v3.json，少一个斜杠或拼错字母就静默失败 - 路径里必须含
/raw/master/，否则返回 HTML 页面而非 JSON - 不能用旧博客里的 php.cn 或 raw.githubusercontent.com 地址，2026 年已全部失效
手动安装插件时路径和命名不能错半分
下载的 .sublime-package 文件必须放进 Packages/ 目录（不是 Installed Packages/），且不能重命名、不能放子文件夹。路径示例：
- Windows：
%APPDATA%\Sublime Text 3\Packages\ - macOS：
~/Library/Application Support/Sublime Text 3/Packages/ - Linux：
~/.config/sublime-text-3/Packages/
装完必须彻底退出 Sublime：Windows 检查任务管理器里 sublime_text.exe 是否清空；macOS 右键 Dock 图标选 Quit（不是关窗口）；Linux 执行 pkill -f sublime。
杀毒软件和 hosts 是最常被忽略的两个干扰项
即使换了源，仍卡在 “Installing 1 package”，优先排查这两点：
- 火绒、360、腾讯电脑管家会静默拦截
urllib.request的 HTTPS 请求，临时禁用再试 - 检查系统
hosts文件是否写了错误的packagecontrol.io或scs-1.packagecontrol.ioIP，哪怕你已换源，GPG 签名校验阶段仍会尝试连接这些域名
真正生效的标志只有一个：重启后按 Ctrl+Shift+P 输入 Package Control: Install Package，列表能正常弹出。
