package control连不上插件服务器主因是channels为空或失效,需手动替换为gitee镜像地址并重启;手动安装插件须重命名去-master、严格大小写、放入packages根目录;装后异常优先检查package control本体是否损坏或版本错配。

Package Control 连不上插件服务器,不是插件坏了,也不是你网络全断了——大概率是它根本没拿到可用的插件列表地址,或者拿到了但加载失败。换源或手动装,10 分钟内就能恢复。
“Install Package”空白或“No packages available”怎么破
这是最典型的症状,控制台往往静默无输出,左下角只闪一下“Loading…”。根本原因只有两个:channels为空、失效,或网络不可达。
- 打开
Preferences > Package Settings > Package Control > Settings – User,检查"channels"字段是否为空数组([])或含已失效链接(如过期的 Gist URL) - 国内用户直接换成 Gitee 镜像,例如:
{"channels": ["https://gitee.com/akira-cn/package_control_channel/raw/master/channel_v3.json"]} - 保存后必须重启 Sublime Text —— 热重载不生效,改完立刻按
Ctrl+Shift+P输入Package Control: Install Package测试 - 如果仍卡住,说明该镜像在你当前网络下也不通(Gitee 有时限流),换另一个地址,或跳过网络走手动安装
手动安装插件:命名和路径一个都不能错
手动安装不是“把 ZIP 解压扔进去”就完事。Sublime 只认文件夹名,且严格区分大小写;放错位置、名字带 -master 或后缀,插件就等于没装。
- 去
https://packagecontrol.io/packages/插件名页面,点 “Source” 进 GitHub 仓库 - 点击
Code > Download ZIP,解压后得到类似EmacsProMode-master的文件夹 - 重命名为
EmacsProMode(去掉-master,不加任何后缀,大小写与官网页面完全一致) - 复制到对应
Packages目录:
Windows:C:\Users\<username>\AppData\Roaming\Sublime Text 4\Packages\</username><br> macOS:<code>~/Library/Application Support/Sublime Text 4/Packages/<br> Linux:<code>~/.config/sublime-text-4/Packages/</code></code>
装了插件但功能异常?先看 Package Control 本体有没有坏
快捷键不响应、设置项不出现、Preferences > Package Settings 里压根找不到插件名——这些不是插件问题,而是 Package Control 自身损坏或版本错配。
- 常见诱因:多次手动覆盖
Package Control.sublime-package、混用同名文件夹和 .sublime-package 文件、ST4 强行装 ST3 版插件 - 错误现象包括:
ImportError: No module named 'urllib3'(ST4 装了 ST3 插件)、控制台报failed to load plugin但没具体路径 - 终极修复:访问
https://packagecontrol.io/installation复制最新 Python 安装代码,进 Sublime 控制台(Ctrl+`)粘贴运行,完成后重启
代理、证书、hosts 都配了还连不上?检查这几个隐蔽点
代理配置写了但控制台没看到 via http://127.0.0.1:7890?证书信任设了但提示 SSL 错误?这些都不是玄学,而是细节没对齐。
-
http_proxy和https_proxy必须是http://开头,https://会静默失效;SOCKS5 地址(如127.0.0.1:1080)不支持,得切 HTTP 模式 - 证书错误优先校准系统时间(差几分钟都可能触发 TLS 验证失败),再确认钥匙串中
ISRG Root X1或DigiCert根证书设为“始终信任” - 改
hosts文件时,记得刷新 DNS 缓存(Windows 执行ipconfig /flushdns,macOS 执行sudo dscacheutil -flushcache) - Windows 防火墙可能拦截
sublime_text.exe出站请求,在“允许应用通过防火墙”里手动勾选它











