package control安装失败主因是网络链路、脚本版本不匹配或路径放错；哈希校验失败需重复制官网最新脚本，命令不出现应删净旧包并放入installed packages/目录，channel无效须验证镜像url可访问且重启生效。
Package Control 安装失败，90% 不是插件问题，而是网络链路、脚本版本或路径放错导致的——先别重装，按错误现象对号入座。
控制台执行脚本后显示 “Error validating download”
这是哈希校验失败，不是网络没连上，而是下载下来的 Package Control.sublime-package 文件和脚本里预设的 h 值不一致。
- 最常见原因是：从网页、PDF 或截图复制了带不可见字符（如全角空格、零宽字符）的脚本，粘贴进控制台后 Python 解析出错
- 另一个主因是脚本过期：官网 packagecontrol.io/installation 页面会随 Sublime 版本自动切换脚本，ST4（
sublime.version()返回 4xxx）必须用含urllib.request和hashlib.sha256的新版；ST3 用旧版但哈希值也得匹配当前页面所列 - 别手动改脚本里的
h值——它由官方动态生成，改了也没用；直接刷新页面，重新复制整段“Manual Installation”区块下的代码 - 粘贴前，在控制台先敲
import urllib.request回车，报ModuleNotFoundError就说明你正用 ST3 脚本跑在 ST4 上，立刻换脚本
命令面板搜不到 “Package Control: Install Package”
说明 Package Control 根本没加载进运行时，不是“装了没反应”，而是“压根没进来”。
- 先确认是否真没装上：按
Ctrl+`打开控制台，输入sublime.version()看版本；再输sublime.installed_packages_path()看返回路径，然后去文件系统里检查该路径下的Installed Packages/目录里有没有Package Control.sublime-package - 如果文件存在但命令仍不出现，大概率是残留旧包干扰：进
Installed Packages/，删掉所有含Package Control字样的文件（包括Package Control.sublime-package和可能存在的Package Control (old).sublime-package），再重跑最新脚本 - 别把
.sublime-package文件丢进Packages/目录——Sublime 只扫描Installed Packages/下的这类文件，Packages/是给解压后的插件文件夹用的 - 重启必须是「完全退出」：Windows 右键任务栏图标选「退出」，macOS 在菜单栏选「Sublime Text → Quit Sublime Text」，只关窗口不行
装上了却提示 “There are no packages available”
这不是 Package Control 没装好，是它的插件列表地址（channel）根本没通，国内用户十有八九卡在这步。
- 打开
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 的地址在 2026 年已全部 404；也别漏掉
/raw/master/这一段路径 - 保存设置后必须重启 Sublime——这个配置不热重载，改完不重启等于没改
- 如果控制台报
schema_version mismatch，说明用了 v2 channel（channel.json）配新版 Package Control，必须统一用channel_v3.json
控制台报 ssl.SSLCertVerificationError 或空白无响应
这是 HTTPS 握手失败，常见于公司网、教育网、开了代理但没配 SSL，或系统时间偏差超 5 分钟。
- 先校准系统时间：Windows 在「设置 → 时间和语言 → 同步时间」开启自动同步；macOS 打开「系统设置 → 通用 → 日期与时间」并勾选「自动设置日期与时间」
- 临时绕过（仅调试）：在控制台先运行
import ssl; ssl._create_default_https_context = ssl._create_unverified_context，再粘贴安装脚本。但别长期这么用，否则后续插件更新也会失败 - Clash/Surge 等代理工具默认不被 Sublime 继承：urllib.request 不读系统代理，需在
Package Control → Settings – User里显式填"http_proxy"和"https_proxy"，格式必须是"http://127.0.0.1:7890"（注意是http://，即使代理监听 HTTPS） - macOS 用户可导出 packagecontrol.io 证书：钥匙串里搜索该域名 → 右键导出为
packagecontrol.crt→ 控制台运行import certifi; print(certifi.where())，把证书追加进输出路径下的cacert.pem
最容易被忽略的是：channel 地址无效 + 未重启 + 路径放错三者叠加。很多人试了五种方法，其实只差一步——把镜像 URL 粘进浏览器确认能打开，删净旧包，放进正确的 Installed Packages/，再彻底退出重开。
