Sublime Text插件无法安装的根本原因是Package Control无法获取远程channel列表,解决方案包括更换国内镜像源、手动离线安装或重装Package Control。

Sublime Text 无法连接插件服务器,本质是 Package Control 拿不到远程插件列表(channel),不是插件本身坏了——绝大多数情况,你根本不需要联网也能装好插件。
为什么“Install Package”界面空白或提示“No packages available”
这是最典型的症状,控制台可能静默无报错,左下角只显示“Loading…”然后消失。根本原因只有两个:网络不可达 或 channel 地址失效/为空。国内用户几乎全是前者:默认的 https://packagecontrol.io/channel_v3.json 域名解析失败、TLS握手超时、或 JSON 文件被中间设备截断。
- 打开
Preferences > Package Settings > Package Control > Settings – User,检查"channels"是否为空数组或包含已失效地址(如过期的 GitHub Gist URL) - 把配置里的
"channels"改成可用镜像,例如:{ "channels": [ "https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json" ] } - 保存后重启 Sublime —— 不用等“重载完成”,直接按
Ctrl+Shift+P输入Package Control: Install Package,如果仍卡住,说明镜像地址本身在你当前网络下也不通(Gitee 有时会限流),换另一个镜像或走离线路径
手动安装插件(真正离线、100% 可控)
跳过所有网络环节,直接把插件文件放进 Packages 目录。关键不是“下载 ZIP”,而是文件夹命名必须和插件官方名完全一致,否则 Sublime 不识别。
- 去
https://packagecontrol.io/packages/EmacsProMode(以 EmacsProMode 为例)页面,找到 “Source” 链接,点进去看仓库地址(通常是 GitHub) - 在 GitHub 页面点击
Code > Download ZIP,解压后得到一个文件夹,比如EmacsProMode-master - 把它重命名为
EmacsProMode(去掉-master,不加任何后缀) - 复制到你的 Packages 目录:
Windows:C:\Users\\AppData\Roaming\Sublime Text 4\Packages\
macOS:~/Library/Application Support/Sublime Text 4/Packages/
Linux:~/.config/sublime-text-4/Packages/ - 重启 Sublime,插件即生效;若需配置,再打开
Preferences > Package Settings > EmacsProMode
代理或 hosts 失效时的兜底方案
当换源+手动安装都试过,但插件功能异常(比如快捷键不响应、设置项不出现),大概率是 Package Control 本体损坏或版本错配。此时不要修,直接换。
- 关闭 Sublime Text
- 进入 Packages 目录,删除整个
Package Control文件夹 和Package Control.sublime-package文件 - 访问
https://packagecontrol.io/installation,复制 ST4 的 Python 安装代码(注意别选错 ST3 版本) - 启动 Sublime,按
Ctrl+`打开控制台,粘贴代码并回车 —— 看最后一行是否输出reloading settings Packages/User/Package Control.sublime-settings - 成功后立刻按
Ctrl+Shift+P输入Install Package,确认能打开列表,再装其他插件
最容易被忽略的一点:Sublime 的 Packages 目录下有同名文件夹和 .sublime-package 文件时,它会优先加载文件夹;如果你手动装过插件,又通过 Package Control 再装一次,可能造成冲突。遇到行为异常,先检查该插件是否在目录里重复存在。










