90%因网络拦截导致Package Control安装失败，需验证是否被杀毒软件或防火墙静默拦截；优先用Gitee镜像换源或本地channel.json，手动安装须用ST4专用脚本、关闭HTTPS扫描并重启生效。
Sublime Text 无法安装 Package Control 或插件，90% 是因为网络拦截——不是你操作错了，而是 urllib 请求在系统层被静默丢弃。杀毒软件（火绒、360）、企业防火墙、甚至 Windows Defender 都可能拦截 Sublime 的 HTTPS 请求，且不弹提示、不写日志，只让控制台空转或报 URLError。
确认是不是真被拦截了
别猜，直接验证：
- 打开控制台（
Ctrl + `），输入sublime.log_commands(True)，再按Ctrl + Shift + P输入Package Control: Install Package - 如果控制台完全没输出任何 HTTP 相关日志（比如没出现
downloading channel_v3.json），说明请求压根没发出去——就是被拦截了 - 进
Preferences → Browse Packages，往上退一级打开Installed Packages文件夹，确认里面有Package Control.sublime-package（注意是文件，不是文件夹） - 如果存在但命令不注册，检查
Preferences → Settings用户配置里有没有"ignored_packages": ["Package Control"]这行，删掉再保存
绕过拦截的三类实操路径
优先级从高到低：本地 channel > Gitee 镜像 > 代理配置。国内环境建议直接走前两者，代理反而容易因格式错误（如混用 http:// 和 https://）引发新问题。
- 把
channel_v3.json下载到本地，用绝对路径引用：浏览器访问https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json，右键“另存为”，保存为无 BOM 的 UTF-8 文本（不要带.txt后缀），例如C:/sublime/channel_v3.json；然后在Package Control → Settings – User中写：{ "channels": ["C:/sublime/channel_v3.json"] } - 换 Gitee 官方维护镜像（2026 年仍有效）：直接填入
"https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"，不用改其他设置，重启即生效 - 代理仅在明确需要时配置：若公司强制走代理，必须确保
http_proxy和https_proxy值一致且协议匹配（比如都是http://proxy:8080），不能一个写http://一个写https://；配置位置同上，在Settings – User里加两行，不要缩进错误
手动安装 Package Control 时的硬性条件
自动安装失败后，手动执行 Python 脚本是最稳的起点，但有三个不可妥协的条件：
- 必须用官网提供的 ST4 专用代码（2026 年已不兼容 ST3 脚本），否则会报
AttributeError: module 'sublime' has no attribute 'installed_packages_path' - 执行前关闭所有杀毒软件的“网页防护”“HTTPS 扫描”模块——火绒默认开启 HTTPS 拦截，360 会静默重定向 urllib 流量
- 看到控制台输出
Success才算完成，Error validating download表示校验失败，可能是下载中断或 hash 不匹配，需重试而非跳过
真正卡住的地方往往不是“怎么换源”，而是“换完源后没重启 Sublime”或者“JSON 文件带了 BOM 头导致解析失败”。这两点没有报错，但会让整个流程静默失效——重启和验证 JSON 可读性，比反复调 proxy 更关键。
