Package Control 报错“Unable to download package list”等主因是默认源不可达，需先确认是否安装成功、版本匹配、文件路径正确，再换用可靠镜像源并重启。
Package Control 报错“Unable to download package list”或“There are no packages available”，不是插件坏了，也不是你网络完全断了，而是它默认请求的 <a href="https://www.php.cn/link/19b20d918b26f877ce5a1ad7f34b9729">https://www.php.cn/link/19b20d918b26f877ce5a1ad7f34b9729</a> 在国内基本不可达——DNS 污染、TLS 握手失败、CDN 返回空响应，三者占 90% 以上。
确认 Package Control 是否真装上了
别急着换源或配代理，先看它有没有加载成功。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control—— 如果完全没任何提示，说明根本没装好或被静默禁用 - 打开控制台：
View → Show Console，执行print(sublime.version())看返回值：4xxx是 ST4，3xxx是 ST3；版本错配会导致安装脚本静默失败 - 检查
Packages/Installed Packages/目录下是否存在Package Control.sublime-package文件（注意是Installed Packages，不是Packages） - 如果控制台报
ImportError: No module named 'package_control'，说明包文件没解压或路径错误，不是“连不上”，是“根本没跑起来”
手动安装 Package Control 必须用匹配版本的脚本
官网页面会自动识别你的 Sublime 版本并给出对应脚本，但很多人复制时混入中文引号、换行符或空格，导致 SyntaxError: Non-UTF-8 code starting with ''。
- ST4（Build ≥ 4126）必须用含
urllib.request的脚本，不能用 ST3 的urllib2版本；反之亦然 - 粘贴前全选控制台内容，按
Ctrl+A → Delete清空，再整行粘贴（不要分段、不要回车中断） - 执行后若无输出，不代表失败；看右下角状态栏是否出现
Package Control: Installing dependencies—— 出现即表示已触发 - 若报
ssl.CertificateError，先校准系统时间（误差超 5 分钟必炸 SSL）；临时调试可加一行：import ssl; ssl._create_default_https_context = ssl._create_unverified_context，但仅限单次验证
换 channel 源不是可选项，是必做动作
装完 Package Control 后仍空白，99% 是 "channels" 地址打不开。浏览器直接访问你配置的 URL，必须能返回完整 JSON，否则 Sublime 就当它不存在。
- 打开
Preferences → Package Settings → Package Control → Settings – User - 填入可用的 v3 镜像（2026 年实测有效）：
{ "channels": [ "https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json" ] } - 切勿使用已失效链接（如 php.cn 域名、旧版
/channel.json路径）；/raw/master/channel_v3.json这段路径缺一不可 - 保存后必须重启 Sublime —— 设置不热重载，改了也不生效
- 如果仍卡住，删掉
Cache/Package Control/下所有.json和.cache文件，再重启
离线安装插件时命名和路径必须严丝合缝
手动放插件进 Packages/ 目录却没反应？大概率是文件夹名错了，或放错了地方。
- 插件官方名是
EmacsProMode，GitHub 下载 ZIP 解压后叫EmacsProMode-master，你必须重命名为EmacsProMode（去掉-master，不加后缀） - 路径必须是：
Packages/EmacsProMode/（直接在Packages根目录下），不能是Packages/User/EmacsProMode/或Packages/Default/ - 如果是
.sublime-package文件（如EmmyLua.sublime-package），应放进Installed Packages/目录，而非Packages/ - 装完检查
Preferences → Package Settings里有没有对应菜单项；没有？大概率是ignored_packages里悄悄屏蔽了它（搜一下设置文件里有没有这行）
最常被忽略的一点：Sublime 不读系统代理，Clash/Surge 开着也白搭，除非你在 Package Control 设置里显式写上 "http_proxy"，且端口必须和代理工具监听端口一致。但比配代理更稳的，是直接换镜像源 + 离线安装组合拳——毕竟，它本质是个 Python 包管理器，不是浏览器。
