控制台顶行红色报错指向插件真凶，按ctrl+`打开控制台，file路径中的xxx即插件名；importerror等属兼容问题；channel加载失败需验证url有效性并重启；ignored_packages会静默屏蔽插件；ssl失败应校准时间、更新证书而非关闭验证。
控制台顶行红色报错就是插件真凶
别管弹窗标题写什么，按 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，覆盖原文件 - Sublime Text 4 中该路径可能不存在，需手动创建
Packages/Package Control/certifi/目录再放进去 - 确认配置中
"ssl_verification": true（默认就是true），重启后走正常 HTTPS 验证
最常被忽略的是：控制台第一行报错没细看，就去重装插件；channel 地址改了不重启；ignored_packages 里藏着插件名却以为装失败了；系统时间偏差超过五分钟还硬等 SSL 握手成功。
