插件安装失败主因是Package Control资源获取失败、SSL证书验证失败或被ignored_packages屏蔽；需依次检查channel地址有效性、系统时间与证书、ignored_packages配置及依赖模块是否以.sublime-package形式安装。
插件安装时报错，八成不是插件坏了，而是 Package Control 拿不到资源、证书验证失败，或插件本身被 Sublime 主动忽略。 直接删插件重装没用，得先定位是哪一层断了。
报“There are no packages available”——channel 地址根本打不开
这个提示不是插件问题，是 Package Control 请求 channels 地址返回空或超时。国内用户基本都卡在这步。
- 打开
Preferences → Package Settings → Package Control → Settings – User，检查"channels"字段是否为空，或只有一条旧地址（比如"https://packagecontrol.io/channel_v3.json"） - 把里面的 URL 粘到浏览器地址栏访问——能加载出完整 JSON 才算有效；打不开就说明被拦截或 DNS 失败
- 换国内镜像更稳：
"https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json" - 改完必须重启 Sublime，配置才生效；不重启等于白改
控制台刷 SSL: CERTIFICATE_VERIFY_FAILED——证书链过期或系统时间不准
错误常出现在公司网络、杀软拦截环境，或系统时间误差超过 5 分钟。别关 ssl_verification，那只是掩耳盗铃。
- 先校准系统时间：误差 >5 分钟会直接触发 SSL 验证失败
- 进
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 验证
插件装上了但命令面板搜不到、快捷键无效——它被 ignored_packages 屏蔽了
这不是没装成，是 Sublime 在后台悄悄禁用了。常见于手动安装后未清理旧配置，或其它插件冲突导致自动加入黑名单。
- 打开控制台（
View → Show Console），搜ignored_packages或disabled packages，看输出里有没有你的插件名 - 编辑用户设置：
Preferences → Settings – User，找到"ignored_packages"这一行，整行删掉，或从中移除对应插件名（比如"SideBarEnhancements"） - 检查插件路径是否放错：.sublime-package 文件必须放进
Installed Packages/；解压后的文件夹必须整体放进Packages/根目录，不能嵌套进子目录 - 重启 Sublime 后再验证，不重启不会刷新 ignored 列表
控制台反复报 ImportError: No module named 'mdpopups'——依赖没走 Package Control 装
这类报错和插件本身无关，是它依赖的底层模块缺失。Sublime 的 Python 环境完全隔离，pip install 无效，所有依赖必须以 .sublime-package 形式安装。
- 别用系统 pip 安装
mdpopups、python-markdown、jinja2—— 它们不会被 Sublime 加载 - 确保
channels正常后，在命令面板搜Package Control: Install Package，单独搜索并安装这些依赖名（如mdpopups） - 某些插件（如 Emmet）曾依赖已停更的
PyV8，现在应避开，改用官方推荐的现代替代方案 - 离线环境可去 Gitee 镜像页下载对应
.sublime-package文件，直接丢进Installed Packages/目录
最容易被忽略的是：改了 Settings – User 不重启、换了 channel 地址不验证浏览器能否打开、装了依赖却用 pip 而非 Package Control。这些环节任一卡住，都会让问题看起来像“插件坏了”。
