Sublime插件弹窗报错多数源于Package Control状态异常或缓存损坏，应直接重装而非调代理；需删除Packages和Installed Packages中相关文件，重启后通过命令面板执行Install Package Control，并配置https_ca_bundle修复SSL证书问题。
Sublime Text 安装插件时弹窗报错，绝大多数情况不是网络问题，而是 Package Control 自身状态异常或缓存损坏 —— 直接重装它比调代理、换源更有效。
检查 Package Control 是否已损坏
打开 Sublime Text，按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）调出命令面板，输入 Package Control: Install Package。如果命令根本不出现在列表里，说明 Package Control 没加载成功；如果点了没反应或弹出 There are no packages available，大概率是本地元数据损坏。
- 打开菜单
Preferences → Package Settings → Package Control → Settings – User，检查文件是否为空或只有一行{} - 终端中执行
subl --command "package_control_upgrade"（仅限已正确注册 CLI 的安装），若报错Unknown command，也指向插件未就绪 - 查看控制台（
Ctrl+`）是否有类似reloading plugin Package Control.12345... ImportError: cannot import name 'ssl'的报错，常见于 Python 环境冲突
彻底重装 Package Control
别试图“修复”，直接删干净再装。关键路径和操作顺序不能错：
- 关闭 Sublime Text
- 删除
Packages/Package Control文件夹（路径：~/.config/sublime-text-3/Packages/Package ControlLinux/macOS；%APPDATA%\Sublime Text 3\Packages\Package ControlWindows） - 删除
Installed Packages/Package Control.sublime-package（同级目录下） - 重新启动 Sublime Text，立刻按
Ctrl+Shift+P输入Install Package Control，选择该命令执行（它会自动从官网拉取最新稳定版） - 等待右下角出现
Package Control: Installed提示，再试Install Package
遇到 SSL: CERTIFICATE_VERIFY_FAILED 怎么办
这不是证书过期，而是 Sublime Text 内置的 Python 未正确加载系统 CA 证书链，尤其在企业网络或 macOS 14+ 上高频出现。不建议关 SSL 验证（不安全），优先用以下方式：
- 确认系统已安装
certifi：终端运行python3 -c "import certifi; print(certifi.where())"，记下路径 - 在
Preferences → Package Settings → Package Control → Settings – User中添加：
{
"install_prereleases": [],
"http_timeout": 30,
"https_ca_bundle": "/path/to/certifi/cacert.pem"
}
把 /path/to/certifi/cacert.pem 替换成上一步输出的真实路径。Windows 用户注意用正斜杠或双反斜杠。
插件安装后不生效或报 ImportError
典型表现：装完 SideBarEnhancements，右键没新菜单；或装 MarkdownPreview 后按快捷键报 No module named 'markdown'。本质是插件依赖的 Python 包未被 Sublime 加载：
- Sublime Text 4 默认使用自带 Python 3.8，不读取系统
site-packages，所有依赖必须打包进插件目录 - 优先选带
.sublime-package后缀的发布版（如从https://packagecontrol.io/packages/SideBarEnhancements下载），避免 GitHub raw 直链安装（缺依赖打包） - 若必须手动安装，把插件整个文件夹放进
Packages/后，检查其dependencies字段（如有.dependency-sublime或package-metadata.json），按提示补全
最常被忽略的一点：重装 Package Control 后，之前通过它安装的所有插件不会自动恢复 —— 你得手动再装一遍，但这次成功率极高。
