控制台首行红色报错直接定位插件名,如“file './packages/emmet/main.py'”即问题在emmet;importerror 'create_connection'说明插件调用不支持的标准库函数,需换兼容版或删除;ssl/urlopen错误属package control网络层失败,非插件问题。

控制台顶行报错直接定位插件名
别管弹窗标题写什么,按 Ctrl + ` 打开控制台,第一行红色堆栈里的 File "./Packages/XXX/xxx.py" 中的 XXX 就是真凶。比如出现 File "./Packages/Emmet/main.py",问题就在 Emmet 插件本身。
常见误判点:
-
ImportError: cannot import name 'create_connection'—— 插件调用了 Sublime 嵌入 Python 不支持的标准库函数,得换兼容版本或删掉 -
ssl、urlopen、certifi相关错误 —— 不是你装的插件出问题,是Package Control自身网络层失败 -
NoneType is not callable—— 插件主文件里某个回调(如on_activated)被删了或没定义,不是配置问题
“There are no packages available”本质是 channel 加载失败
这不是插件列表空,是 Package Control 根本没拿到 JSON 数据。打开 Preferences → Package Settings → Package Control → Settings – User,检查 "channels" 字段。
必须做三件事:
- 把配置里的 URL 粘到浏览器里直接访问 —— 能加载出完整 JSON 才算有效;打不开就换源。国内推荐用:
"https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json" - 改完必须重启
Sublime,不重启等于白改 - 旧链接如
packagecontrol.io/channel_v3.json在 2026 年已大面积404
插件装上了但命令面板搜不到
大概率被 ignored_packages 静默屏蔽了。这不是没装成,是 Sublime 启动时自动跳过加载。
验证和修复步骤:
- 控制台输入:
sublime.load_settings('Preferences.sublime-settings').get('ignored_packages'),回车看输出是否含你的插件名(如"SideBarEnhancements") - 打开
Preferences → Settings – User,找到"ignored_packages"这一行,删掉对应插件名或整行注释掉 - 保存后必须重启
Sublime,否则设置不生效 - 注意:插件路径也得对 ——
.sublime-package文件放Installed Packages/,解压后的文件夹整体放Packages/根目录,不能嵌套
SSL 验证失败别关 ssl_verification
SSL: CERTIFICATE_VERIFY_FAILED 错误常因系统时间不准(误差 >5 分钟)、证书过期或杀软拦截引起。关掉验证只是掩耳盗铃。
真正修复方式:
- 先校准系统时间
- 进
Preferences → Browse Packages…,打开Packages/Package Control/certifi/cacert.pem - 从
https://www.php.cn/link/5fe4dadcdb001d8566cd20e6d8a20251下载最新cacert.pem,覆盖原文件 - 确认配置中
"ssl_verification": true(默认就是true),重启后走正常 HTTPS 验证
最麻烦的不是报错本身,而是多个问题叠加:channel 失效 + ignored_packages 屏蔽 + 路径放错 + 系统时间偏差,四者可能同时存在,但控制台第一行永远只告诉你一个起点。











