插件列表空白或转圈本质是Package Control无法连接默认源,主因是DNS解析或TLS握手失败;Sublime不走系统代理,需手动换国内镜像源(如清华源)并重启解决。

插件列表空白或一直转圈,Package Control 没反应
本质是 Package Control 无法连接默认源(https://packagecontrol.io),多数情况不是插件坏了,而是网络卡在 DNS 解析或 TLS 握手环节。Sublime Text 3/4 默认不走系统代理,也不读取环境变量,所以即使浏览器能上,它也可能连不上。
- 先确认是否真连不上:打开
Ctrl+`调出控制台,手动执行import urllib.request; urllib.request.urlopen('https://httpbin.org/get').read()—— 如果报URLError或卡住,说明网络层已阻断 - 别急着重装
Package Control,90% 的问题靠换源就能解决 - 不要用「科学上网」软件的全局模式去“喂” Sublime,它不识别 socks/http 代理,反而容易触发证书校验失败
怎么换国内可用的插件源(channel_v3.json 替换)
Sublime 的插件源地址硬编码在 Package Control.sublime-settings 里,直接改 channels 数组即可。官方源被墙,但社区维护的镜像基本稳定,比如清华源、腾讯云源。
- 打开菜单
Preferences → Package Settings → Package Control → Settings - 把原
"channels"数组里的"https://packagecontrol.io/channel_v3.json"换成:"https://mirrors.tuna.tsinghua.edu.cn/packagecontrol/channel_v3.json" - 保存后重启 Sublime,再按
Ctrl+Shift+P输入Package Control: Install Package,列表应该秒出 - 如果仍慢,可能是 DNS 污染,可在系统 hosts 里加一行:
114.114.114.114 packagecontrol.io(仅临时测试用)
Package Control 安装后没出现在命令面板?
常见于手动下载安装或旧版残留冲突。Sublime 不会自动激活刚放进去的插件,得靠正确路径和文件名触发加载。
- 确保插件解压后目录名是
Package Control(大小写敏感),且放在Packages/下,不是Installed Packages/ - 检查
Packages/User/Package Control.sublime-settings是否为空或语法错误(JSON 格式必须严格,少个逗号就静默失败) - 控制台里输入
sublime.list_packages(),看返回数组里有没有'Package Control'—— 没有就是根本没加载 - Windows 用户注意:杀毒软件有时会拦截
Package Control的 HTTPS 请求,临时禁用试试
为什么有时候装完插件不生效,或者 Ctrl+Shift+P 找不到命令?
不是所有插件都自动注册命令,有些依赖特定文件类型或需要手动启用。更隐蔽的问题是插件本身不兼容当前 Sublime 版本(尤其是 ST4 对 Python 3.8 的改动)。
- 装完插件后,先看控制台有没有
ImportError或SyntaxError—— 很多插件没适配 ST4,会直接 import 失败 - 检查插件的
.sublime-commands文件是否存在,没有这个文件,命令面板就不会显示它的命令 - 某些插件(如
SideBarEnhancements)需要右键菜单触发,不会出现在命令面板,默认快捷键也未必预设 - 如果插件带设置文件,务必复制一份到
Packages/User/下再改,直接改原插件目录会被升级覆盖










