Package Control安装失败主因是网络阻断,需手动下载.sublime-package文件放入Installed Packages目录并替换channels为国内镜像。

Package Control安装失败,八成是网络卡在 packagecontrol.io 和 github.com raw 资源上
不是你 Sublime 版本旧、没重启、或者路径选错——而是控制台执行脚本时第一行 urllib.request.urlopen('https://packagecontrol.io/Package Control.sublime-package') 就超时或抛 URLError。国内多数地区访问这两个域名会触发 DNS 污染或 TLS 握手中断,导致下载失败、GPG 校验跳过、甚至命令面板里根本搜不到 Package Control: Install Package。
验证方式很简单:打开 Sublime 控制台(Ctrl + `),手动粘贴官方 ST4 脚本后等满 5 秒,如果状态栏没出现 Success 或控制台只显示 Traceback,基本可判定是网络层阻断。
- 别反复点菜单里的 “Install Package Control” —— 那只是调用同一段失败脚本
- 别用系统 Python 的 pip 安装 —— Sublime 自带 Python 环境,不认外部证书链和 urllib 版本
- 检查系统时间是否偏差 >5 分钟 —— 否则
ssl.CertificateError会静默失败
手动安装 Package Control.sublime-package 到 Installed Packages/ 目录
这是最稳的兜底方案,绕过所有网络请求,直接让 Sublime 加载二进制包。关键不是“解压到 Packages/”,而是把完整文件(含 .sublime-package 后缀)丢进 Installed Packages/ —— 这个目录和 Packages/ 是平级的,搞混会导致插件加载失败甚至命令面板无响应。
操作步骤:
- 点击
Preferences → Browse Packages…,看到路径类似…/Sublime Text/Packages,往上退一级,进入Installed Packages文件夹 - 从可信镜像下载最新
Package Control.sublime-package(2026 年推荐用 Gitee 镜像:https://gitee.com/azl397985856/package_control_channel/raw/master/Package%20Control.sublime-package) - 确认文件名完全一致,不能是
Package-Control.sublime-package或package_control.sublime-package,大小写和空格都必须原样 - 拖入后彻底退出 Sublime(右键托盘图标选 Exit),再重新打开
生效标志:按 Ctrl + Shift + P,输入 Package Control: List Packages,能弹出一个(哪怕空的)列表,说明框架已加载。
修改 Package Control.sublime-settings 中的 channels 字段
即使 Package Control 装上了,There are no packages available for installation 依然常见——问题不在插件本身,而在它默认去请求 https://packagecontrol.io/channel_v3.json,这个地址在国内基本不可达。
正确做法是替换为可用镜像,且必须是能返回标准 JSON 格式、字段结构兼容的 channel 地址:
- 优先试
"https://erhan.in/channel_v3.json"(2026 年仍稳定) - 备选
"https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"(Gitee 镜像,国内直连) - 若两者都打不开,就下载该 JSON 内容保存为本地文件,例如
D:/sublime/channel_v3.json,然后填绝对路径"file:///D:/sublime/channel_v3.json" - 不要用 HTTP 协议(如
http://…)—— Sublime 3/4 默认禁用非 HTTPS channel
配置位置:Preferences → Package Settings → Package Control → Settings – User,只改 channels 数组,其他字段保留或删掉也无妨,但必须确保 JSON 语法合法(末尾无逗号、引号闭合)。
ignored_packages 里误加了 "Package Control"
装完发现菜单里没有 Preferences → Package Control,命令面板也补全不出任何 Package Control: 命令?大概率是用户设置里悄悄屏蔽了它。
检查 Preferences → Settings(注意是通用 Settings,不是 Package Control 专属设置),搜索 ignored_packages 字段。如果里面包含 "Package Control",把它删掉并保存。这个字段是全局插件黑名单,一旦命中,Sublime 会彻底跳过加载,连错误提示都不会给。
顺带一提:有些旧教程教人把插件文件夹重命名为 PackageControl(无空格)并扔进 Packages/,这在 ST4 上已失效,反而会因路径冲突导致 Package Control 初始化失败,建议清空 Packages/ 下所有疑似残留文件夹再重试。


















