Sublime Text插件安装失败主因是Package Control未加载或无法访问channel文件，需先验证其是否启动、再检查网络连通性及channel地址有效性，最后确保配置修改后彻底重启。
Sublime Text 安装插件报错，绝大多数情况不是插件本身有问题，而是 Package Control 没真正跑起来，或者它连不上插件源——得先确认它是否加载、再查它能不能访问 channel 文件。
Package Control 根本没加载，Install Package 命令不出现
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Package Control，如果完全没反应，说明它压根没进运行时环境。这不是网络问题，是 Sublime 启动时根本没载入这个模块。
- 打开控制台：
View → Show Console，粘贴 ST4 官方安装脚本（带hashlib.sha256校验的那版），回车执行 - 看到
Package Control installed或控制台输出路径写入日志才算成功；若报URLError或超时，别反复重试，直接切到换源步骤 - 装完必须彻底退出 Sublime（右键任务栏选「退出」，不只是关窗口），再重启，否则命令不会出现
- 某些汉化版会删掉原始包管理器入口，建议用官网原版 + 中文语言包替代
There are no packages available 的真实原因
这个提示本质是 Package Control 请求 channels 地址返回空 JSON 或 404，和你装什么插件无关。国内用户几乎全卡在这步。
- 进入
Preferences → Package Settings → Package Control → Settings – User，确认"channels"至少有一条可用地址，例如："https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json" - 把该 URL 粘到浏览器里直接访问——能加载出完整 JSON 才算有效；打不开就换网络、关杀毒软件（火绒/360 常静默拦截
urllib请求） - 别用博客里抄的旧链接，比如某些 php.cn 的 channel 地址在 2026 年已全部 404
- 绝对路径引用本地文件时，斜杠要写成双反斜杠：
"C:\Users\xxx\channel_v3.json"
控制台刷出 ImportError 或 ssl 相关错误
堆栈最顶行的 File "./Packages/XXX/xxx.py" 中的 XXX 就是问题插件名。别只扫弹窗标题，线索全在第一行。
- 若报
ImportError: cannot import name 'create_connection'，说明插件误调用了 Sublime 嵌入 Python 不支持的标准库函数，得换兼容版本或删掉 - 若报错含
ssl、certifi或urlopen，这不是你装的插件的问题，而是 Package Control 自身网络层失败，应转向检查证书和系统时间 - 运行
sublime.load_settings('Preferences.sublime-settings').get('ignored_packages')查看输出，如果插件名在里面，说明被静默屏蔽，需手动从用户设置中删掉并重启 -
.sublime-package文件必须放进Installed Packages/；解压后的文件夹必须整体放进Packages/根目录，不能嵌套、不能改名（如Emmet-master→ 必须重命名为Emmet）
SSL 验证失败或系统时间不准引发连接中断
报 SSL: CERTIFICATE_VERIFY_FAILED 不是网络不通，而是证书链过期或系统时间误差超过 5 分钟。临时关掉 ssl_verification 只是掩耳盗铃。
- 先校准系统时间：误差 >5 分钟会直接触发 SSL 验证失败
- 进入
Packages/Package Control/certifi/cacert.pem（通过Preferences → Browse Packages…打开），从 https://www.php.cn/link/04c165998a3bfee2c2b46a8d8840dacc 下载最新cacert.pem覆盖原文件 - Sublime Text 4 中该路径可能不存在，需手动创建
Packages/Package Control/certifi/目录再放进去 - 确认配置中
"ssl_verification": true（默认就是 true），重启后走正常 HTTPS 验证
最容易被忽略的是：改完 channels 或 ignored_packages 后不重启 Sublime，等于白改；还有人把 .sublime-package 文件拖进 Packages/ 目录，结果 Sublime 完全无视——这两个目录分工极硬，错一丁点就静默失效。
