手动执行官网最新安装脚本并切换国内镜像源可解决90%的Package Control安装失败问题，需确保脚本时效性、网络通畅、系统时间准确、Sublime版本更新及安装后重启。
绝大多数无法安装 Package Control 的情况，不是 Sublime 本身坏了，而是网络、版本或脚本细节没对上——直接手动执行最新安装脚本 + 换镜像源，90% 能当场解决。
手动安装失败：复制的脚本已过期或粘贴出错
官网 https://www.php.cn/link/befa130dcb31961fa251d61e1e6ba0e1 上的 Python 安装脚本会随安全哈希值更新而变更。你从旧文章、截图或缓存页面复制的代码，h（SHA256 校验值）很可能已失效，导致控制台输出 Error validating download。
- 务必打开官网，只复制“Manual Installation”区块中当前显示的完整
import urllib.request,os,hashlib; ...脚本 - 在 Sublime 中按
Ctrl + `（Windows/Linux）或Cmd + `（macOS）调出控制台，**整段粘贴、不增不减、直接回车** - 若提示
Success，说明包已写入；若报urllib.error.URLError或超时，跳转到下一条
国内网络环境：HTTPS 请求被拦截或 DNS 解析失败
Sublime Text 内置 Python 会直连 packagecontrol.io 和 raw.githubusercontent.com，但这两个域名在国内常被限速或劫持，表现为控制台卡住、无响应、或报 ssl.SSLCertVerificationError。
- 优先改用国内镜像通道：进入
Preferences → Package Settings → Package Control → Settings – User，填入：
{
"channels": ["https://gitee.com/akira-cn/package_control_channel/raw/master/channel.json"]
}
- 保存后重启 Sublime，再试
Package Control: Install Package - 若仍失败，临时修改系统
hosts文件（路径：C:\Windows\System32\drivers\etc\hosts或/etc/hosts），追加两行：
50.116.34.243 packagecontrol.io 50.116.34.243 sublime.wbond.net
这两行能绕过 DNS 污染，指向真实服务器 IP。
SSL 或时间错误：系统时间不准或证书库陈旧
Sublime Text 3（尤其是 Build 3176 以前）和部分 Linux 发行版内置的 Python SSL 库不支持 TLS 1.2+，或系统时间偏差超过 5 分钟，会导致 HTTPS 握手失败，控制台可能只显示空白或 Connection reset by peer。
- 检查系统时间：确保年、月、日、时、分完全准确，时区正确（Windows 可在“设置→时间和语言→同步时间”中开启自动同步）
- 升级 Sublime Text：ST3 用户建议升至 Build 3211+，ST4 用户请确认是最新正式版（2026 年当前为 v4.4.2）
- macOS 用户若用 Homebrew 安装过旧版 OpenSSL，可能干扰内置 Python，此时应卸载冲突库或直接下载官方 dmg 安装包覆盖
安装后无反应：插件未加载或菜单未刷新
即使控制台显示 Success，也有可能因为缓存未清、配置未生效，导致 Preferences 菜单里找不到 Package Control，或命令面板搜不到 Install Package。
- 重启 Sublime Text 是必须步骤，不能跳过
- 重启后按
Ctrl + Shift + P（或Cmd + Shift + P），输入Package Control，看是否出现相关命令 - 若仍无，执行一次
Package Control: Clear Package Control Cache（需先确保 Package Control 已存在），再重启 - 极端情况下，可手动验证插件文件是否存在：
sublime.installed_packages_path()返回路径，进去确认有Package Control.sublime-package文件
真正卡住的地方往往不是技术多复杂，而是你复制的脚本不是官网最新的、hosts 没改对 IP、或者重启前就急着点菜单——耐心核对每一步的反馈信息，比重装十遍更有效。
