Package Control连接失败主因是网络链路问题，需修复直连packagecontrol.io和raw.githubusercontent.com的路径；装上后提示“There are no packages available”是因为channel_v3.json地址未通，须在Settings–User中配置有效镜像并重启。
Package Control 连接失败，90% 是网络链路问题，不是插件或编辑器故障；国内用户几乎全是 packagecontrol.io 和 raw.githubusercontent.com 直连不通导致的，换源、改路径、清缓存这三步做完，80% 的情况就能立刻恢复安装。
为什么装上了却提示 “There are no packages available”
这是最常被忽略的一环：Package Control 本体装好了，但它的插件列表地址 https://packagecontrol.io/channel_v3.json 根本没通。浏览器里直接打开这个 URL，如果返回空白页、超时或 404，就说明 channel 断了。
- 进
Preferences → Package Settings → Package Control → Settings – User，确认"channels"数组里至少有一条可用镜像，例如："https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json" - 别用已失效的旧链接（比如结尾是
/channel.json或来自 php.cn 的地址），必须是/channel_v3.json且带/raw/master/路径段 - 保存后必须重启 Sublime —— 设置不热重载，改完不重启等于白改
- 如果 Gitee 也打不开（有时会限流），可换另一个镜像，如
https://gitee.com/akira-cn/package_control_channel/raw/master/channel_v3.json
手动安装 Package Control 失败的常见原因
控制台报 NameError: name 'urllib2' is not defined 或静默无反应，基本就是脚本和版本错配。ST4 必须用含 urllib.request 的新脚本，ST3 用旧脚本，混用必失败。
- 先运行
sublime.version()确认版本：返回4xxx是 ST4，3xxx是 ST3 - ST4 用户必须用官网 https://packagecontrol.io/installation 页面顶部标“Sublime Text 4”的那段单行脚本（含
urllib.request和hashlib.sha256校验） - 粘贴前检查是否混入中文引号、换行符或不可见 Unicode 字符，否则会报
SyntaxError: Non-UTF-8 code starting with '' - 执行后右下角状态栏显示
Package Control: Installing dependencies才算成功；若只闪一下就消失，大概率是脚本未执行
离线安装插件时，.sublime-package 和解压文件夹该放哪
放错路径是手动安装失效的第一原因。Sublime 对 Installed Packages/ 和 Packages/ 有硬性分工，混淆两者，插件永远不会被加载。
-
.sublime-package文件（如Emmet.sublime-package）→ 必须直接丢进Installed Packages/目录，不要解压，重启即生效 - GitHub 下载 ZIP 解压后的文件夹（如
Emmet-master/）→ 必须整体复制进Packages/根目录，重命名为Emmet（去掉-master后缀），不能嵌套在子文件夹里 - 用
Preferences → Browse Packages…打开的是Packages/；它的上一级目录里的Installed Packages/才是另一个位置 - 如果插件装上后命令面板找不到、快捷键无效，先检查
Preferences → Settings – User中是否有"ignored_packages": ["Emmet"]这类屏蔽项
SSL 握手失败、证书错误怎么临时绕过
控制台报 ssl.CertificateError 或 SSL routines:SSL23_GET_SERVER_HELLO:sslv3 alert handshake failure，本质是系统时间不准、证书库缺失或代理配置不全，不是 Package Control 本身的问题。
- 先校准系统时间：误差超过 5 分钟会导致 TLS 验证失败
- 临时调试可用：
import ssl; ssl._create_default_https_context = ssl._create_unverified_context，再粘贴安装脚本（仅限调试，勿长期启用） - 更稳妥的做法是补全证书：macOS 可导出
packagecontrol.io证书，Windows/Linux 可更新系统级cacert.pem（路径用import certifi; print(certifi.where())查） - 公司网络或教育网环境下，务必在
Settings – User中手动配置"http_proxy"和"https_proxy"，Sublime 不读系统代理
真正容易被忽略的是：channel 地址必须能被浏览器直连验证，而不仅仅是“看起来格式对”；还有 Installed Packages/ 和 Packages/ 的物理路径差异，很多人反复重装却始终放错目录。
