控制台顶行file路径直接定位问题插件名，如“emmet”；importerror提示调用不支持函数，ssl/urlopen错误属package control网络层问题；ignored_packages屏蔽需手动移除并重启；channels url须浏览器可访问且修改后必须重启。
控制台顶行报错直接定位插件名
别管弹窗标题写什么，打开控制台（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，覆盖原文件 - 若路径不存在（尤其 ST4），手动创建
Packages/Package Control/certifi/目录再放进去 - 确认配置中
"ssl_verification": true（默认就是 true），重启生效
ignored_packages、证书文件这四点，漏查任意一个都会白忙活。重启不是可选项，是硬性前提。
