插件安装失败主因是网络被墙导致Package Control无法访问源；应手动安装Package Control、换用Gitee镜像源、配置代理或hosts、关闭杀软，并确保手动安装时将完整插件文件夹放入Packages目录。
插件安装失败，八成是 Package Control 连不上源——国内访问 packagecontrol.io 和 GitHub raw 资源被墙，导致下载中断、超时或 GPG 验证失败。这不是你操作错了，是网络层被卡住，换源或绕过网络限制就能解决。
手动安装 Package Control 是最稳的起点
自动安装脚本失效，往往是因为第一行请求就失败了。别反复点“Install Package Control”，直接进控制台执行官方手动代码：
按 Ctrl + ` 打开控制台，粘贴以下代码（适用于 Sublime Text 3/4）：
import urllib.request,os,hashlib; h = '6f4c264a24d237259395a6f7a7eb1a8e' + '6c5b3b5e'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); by = urllib.request.urlopen('https://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download: %s' % dh if dh != h else 'Success'); open(os.path.join(ipp, pf), 'wb').write(by)
看到 Success 就说明包已写入，重启 Sublime 后 Preferences → Package Control 应该出现。
- 如果报
URLError或超时，说明网络不通，跳到下一条 - 如果提示
ssl.CertificateError，先检查系统时间是否准确（误差超过5分钟会导致 SSL 验证失败） - 不要用系统 Python 的 pip 安装 Package Control——它只认自己内置的 urllib 和证书链
换国内镜像源，让 channels 地址真正可访问
即使 Package Control 装上了，There are no packages available for installation 依然常见，本质是 "channels" 里那个 JSON 地址打不开。浏览器里直接访问 https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json，能加载出 JSON 内容才算有效。
修改方式：
菜单 → Preferences → Package Settings → Package Control → Settings – User，填入：
{
"channels": [
"https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"
]
}
- 别用已失效的旧镜像（比如某些博客里抄的 php.cn 链接，2026 年多数已 404）
- 改完必须重启 Sublime，否则缓存仍指向原地址
- 不建议同时写多个 channel——Package Control 会逐个尝试，第一个失败就卡住，反而更慢
代理配置和 hosts 修复要对症下药
有代理但没配对，等于没开；没代理却乱加 proxy 字段，反而引发连接拒绝。
如果你用 Clash / V2Ray / Proxifier，且本地 HTTP 代理端口是 7890，在 Settings – User 里加：
{
"http_proxy": "http://127.0.0.1:7890",
"https_proxy": "http://127.0.0.1:7890"
}
如果没有代理，但想加速 GitHub 访问，可更新 hosts 文件（Windows 在 C:\Windows\System32\drivers\etc\hosts，macOS/Linux 在 /etc/hosts），添加最新 GitHub IP（搜索“GitHub hosts 2026”获取实时列表）。
-
杀毒软件（如火绒、360）常静默拦截 Sublime 的
urllib.request请求，临时关闭再试 - 企业网络可能封了
raw.githubusercontent.com域名，此时 hosts 无效，只能切代理或手动安装 - 以管理员身份运行 Sublime 可绕过部分权限拦截，尤其在 Windows 系统盘路径下写入时
手动安装插件是兜底方案，但路径和命名不能错
当所有网络手段都失效，直接上手动：去 https://packagecontrol.io 搜插件名 → 点进项目 → 找 GitHub 主页 → 点 Code → Download ZIP → 解压 → 把**文件夹整体**扔进 Packages 目录。
Packages 路径：
- Windows：
C:\Users\用户名\AppData\Roaming\Sublime Text 3\Packages\ - macOS：
~/Library/Application Support/Sublime Text 3/Packages/ - Linux：
~/.config/sublime-text-3/Packages/
关键细节：
- 不是把 ZIP 丢进去，也不是解压后只复制 .py 文件——必须是完整文件夹，且文件夹名和插件名一致（比如
SideBarEnhancements插件，文件夹名就得叫SideBarEnhancements） - 别放进
Installed Packages/目录，那里只放 .sublime-package 压缩包，放文件夹无效 - 重启 Sublime 后，按
Ctrl+Shift+P输入插件命令，能搜到才说明加载成功
最容易被忽略的是：你以为装好了，其实只是 Package Control 显示“Installing…”然后静默失败——它不会弹窗报错，也不会重试。务必打开控制台（View → Show Console），看最后一行有没有 reloading plugin 或 error。没有日志，就等于没发生。
