sublime text 插件无法使用本质是网络或插件加载问题:网络层因 dns/tls 阻断导致 channel_v3.json 获取失败,需换清华镜像源并重启;插件未加载则检查路径、文件名、py 文件语法及是否被禁用;plugin_host 崩溃需逐个排查高危插件。

Package Control 控制台报 URLError 或卡住
说明 Sublime Text 根本没连上插件源,不是插件问题,是网络层断在 DNS 或 TLS 握手。Sublime 不走系统代理,也不读 HTTP_PROXY 环境变量,所以浏览器能上,它大概率连不上。
验证方法:按 Ctrl+` 调出控制台,执行:
import urllib.request; urllib.request.urlopen('https://httpbin.org/get', timeout=5).read()
如果报 URLError、TimeoutError,或几秒没反应,就确认是网络阻断。
- 别开全局代理“喂”给 Sublime——它不识别 socks/http 代理,反而容易触发证书校验失败
- 杀毒软件(尤其 Windows 上的 360、腾讯电脑管家)常静默拦截
urllib.request的 HTTPS 请求,临时禁用试试 - 执行完命令后别急着关控制台,看有没有
ssl.SSLError提示,有则基本是 TLS 版本或证书链问题
插件列表空白 / 一直转圈 / 提示 “no packages available”
这是最常见现象,本质是 channel_v3.json 拿不到。默认源 https://packagecontrol.io/channel_v3.json 在国内多数地区解析失败或握手超时。
解决方式是换国内镜像源,直接改配置:
菜单 → Preferences → Package Settings → Package Control → Settings – User,把 "channels" 数组改成:
[
"https://mirrors.tuna.tsinghua.edu.cn/packagecontrol/channel_v3.json"
]
保存后必须重启 Sublime Text 才生效。
- 清华源稳定,但偶尔会因 CDN 缓存延迟导致新插件延迟几小时出现
- 不要用
http://开头的源(如某些博客写的 126 镜像),Sublime Text 4 默认禁用非 HTTPS 源,会静默跳过 - 如果改完仍慢,可临时在系统
hosts文件加一行:114.114.114.114 packagecontrol.io,仅用于测试 DNS 是否污染
装了插件但命令面板搜不到 / 快捷键无效
安装成功 ≠ 插件已加载。Package Control 只负责下载解压,插件是否注册命令、监听事件,取决于它自己是否通过 Python import 成功。
先确认插件文件是否真在正确路径:
- 菜单 → Preferences → Browse Packages…,打开的是
%APPDATA%\Sublime Text\Packages\(Windows)或~/Library/Application Support/Sublime Text/Packages/(macOS) - 检查该目录下是否存在对应插件文件夹,名字必须和 GitHub 仓库名完全一致(大小写敏感,不能带空格或下划线)
- 进插件文件夹,确认有
plugin.py或__init__.py,且无语法错误(哪怕一个逗号错,整个模块 import 失败,Sublime 不报错,只是跳过)
再检查是否被手动禁用:
按 Ctrl+Shift+P 输入 Package Control: Enable Package,看列表里有没有你刚装的插件名。有就选中启用——很多插件默认不激活。
Plugin host has exited unexpectedly 报错
这个错误意味着 Sublime 的插件子进程崩溃了,通常由某个插件引发,且往往不是你最近装的那个。崩溃后所有插件命令都不可用,包括 Package Control 本身。
最快速恢复方式是定位并移除问题插件:
- 按
Ctrl+Shift+P→Browse Packages,进入 Packages 目录 - 先把疑似高危插件删掉,比如
SublimeCodeIntel、PyV8、GoSublime(这些依赖外部二进制或旧版 V8 引擎,极易在 ST4 上触发崩溃) - 删完重启,如果错误消失,再逐个放回测试
注意:plugin_host 崩溃不会留下明显日志,控制台里也常为空。如果你不确定哪个插件惹的祸,就从 Packages/ 目录里把第三方插件文件夹全移走,只留 Package Control 和官方插件,再一个个加回来。
真正麻烦的点在于:崩溃可能隔几分钟才发生,也可能只在打开特定类型文件时触发——这种隐性冲突,得靠排除法硬试。











