安装失败主因是网络问题导致TLS/HTTPS请求失败，需优先用带重试的远程脚本；若报证书或URL错误，则必须手动将Package Control.sublime-package放入Installed Packages/目录并重启验证。
控制台安装失败：不是代码错了，是网络卡在 TLS 或 DNS
Sublime Text 4 官方推荐的安装方式是执行远程脚本，但国内多数环境会静默失败——不是你粘贴错了，而是 urllib.request.urlopen 在发起 HTTPS 请求时被拦截、超时或证书校验失败。状态栏没提示、控制台只闪一下就停，大概率是这原因。
- 优先尝试带自动重试和 HTTPS 的一行命令：
import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8')) - 执行后别立刻关控制台，盯着状态栏 5 秒：出现
Package Control: Successfully installed Package Control才算真成功 - 若报
CertificateError或URLError，说明系统 Python 无法验证 packagecontrol.io 的证书，这时必须切手动安装
手动安装：路径错一格，插件就永远不生效
手动安装唯一要死守的规则是：文件必须放进 Installed Packages/ 目录，且不能解压、不能改后缀、不能放错层级。很多人把 Package Control.sublime-package 拖进了 Packages/（用户插件目录），结果重启后菜单里“看起来有”，但 Ctrl+Shift+P 输 Package Control: List Packages 就报错。
- 先关闭 Sublime Text
- 用菜单
Preferences → Browse Packages…打开目录，然后向上退一级，进Installed Packages/ - 下载地址始终是：
https://packagecontrol.io/Package%20Control.sublime-package（注意空格是 %20） - 拖入后重启，再用
Ctrl+Shift+P运行Package Control: List Packages——能返回空列表，才算真正注册进系统
验证是否真装好：别信菜单，只信命令面板响应
Tools 菜单里看到 “Package Control” 选项，或 “Package Settings” 下有它的子项，都可能是旧版本残留 UI。真正生效的标志只有一个：命令面板能识别并执行它的指令。
- 按
Ctrl+Shift+P（Mac 为Cmd+Shift+P） - 输入
Package Control: List Packages，回车 - 如果弹出空列表（不是报错、不是卡住、不是没反应），说明插件管理器已加载完成
- 如果提示
command not found或直接无响应，说明安装未注册成功，得重来
首次使用 Install Package 卡住：不是插件源没加载，是仓库索引在后台拉取
第一次点 Package Control: Install Package 后，界面可能空白几秒甚至十几秒，这不是崩溃，是它在后台请求 https://packagecontrol.io/repositories.json 并解析所有插件元数据。尤其在国内，这个过程容易被中断或超时，导致列表一直不出现。
- 耐心等满 10 秒，状态栏若显示
Package Control: Loading repository list，就还在干活 - 如果超时，可临时换代理，或等网络稳定后再试；不建议反复点击，可能造成内部状态混乱
- 一旦列表出现，后续所有操作（安装/卸载/更新）都会快很多，因为索引已缓存
