根本原因是package control无法访问被屏蔽的默认源https://packagecontrol.io/channel_v3.json，必须更换为gitee镜像源（如https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json），并彻底重启sublime；手动安装、配置代理或禁用杀软可作为补充方案。
Sublime Text 插件安装慢或卡在 Installing 1 package，根本不是插件本身的问题，而是 Package Control 启动时硬编码去请求的默认源 https://packagecontrol.io/channel_v3.json 在国内多数网络环境下 DNS 解析失败、TCP 连接超时或 TLS 握手被干扰——换源是唯一有效解法，其他操作（调超时、清缓存、重装）基本无效。
确认 Package Control 是否真正装上了
很多人以为“装了”，其实压根没进运行时环境。按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入 Package Control，如果命令面板里完全没出现任何相关选项，说明它根本没加载成功。
- 打开
View → Show Console，粘贴 ST4 官方手动安装代码（含sublime.installed_packages_path()调用的那一版），回车执行 - 看到
Success或日志里明确写出写入路径（如.../Installed Packages/Package Control.sublime-package）才算落盘成功 - 若执行时报
URLError或超时，别反复重试，直接跳到换源步骤 - 装完必须彻底重启 Sublime：macOS 要右键 Dock 图标选
Quit，Windows 要检查任务栏进程是否残留
换 Gitee 镜像源（最稳、最快、2026 年仍可用）
清华源偶尔因 TLS 协议兼容性报错，Gitee 镜像目前实测最可靠，但地址格式错一个字符就静默失效。
- 打开
Preferences → Package Settings → Package Control → Settings – User - 确保 JSON 格式合法（无多余逗号、引号闭合、数组用方括号），只保留一条有效镜像：
"channels": ["https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"]- 必须含
/raw/master/路径段，否则 Gitee 返回 HTML 登录页而非 JSON - 把该 URL 直接粘到浏览器地址栏敲回车——能返回完整 JSON（开头是
{ "packages": [）才算真正通了；404、空白、证书错误都得立刻换
配置代理（有 Clash/V2Ray 时必设）
Sublime 不走系统代理，也不读 HTTP_PROXY 环境变量，开全局代理对它完全无效。
- 在
Package Control → Settings – User中添加两行： "http_proxy": "http://127.0.0.1:7890""https_proxy": "http://127.0.0.1:7890"- 协议必须是
http://，不能写https://或带认证信息（如user:pass@） - 端口必须和你本地代理实际监听端口一致（Clash 默认
7890，但部分配置可能是7891或1080） - 设完先在控制台运行：
import urllib.request; urllib.request.urlopen('https://packagecontrol.io').getcode()，返回200才算真正生效
手动安装插件（网络极差时的保底方案）
换源+代理都无效时，手动安装是最稳定的 fallback，但要注意路径和结构。
- 访问
https://packagecontrol.io或 Gitee 镜像站搜索插件，找到 GitHub 仓库地址 - 用
https://ghproxy.com/代理加速下载 ZIP 包（例如https://ghproxy.com/https://github.com/xxx/yyy/archive/refs/heads/master.zip） - 解压后得到一个文件夹，整体复制进
Packages目录（不是Installed Packages） - 路径示例：
Windows：C:\Users\用户名\AppData\Roaming\Sublime Text 3\Packages\
macOS：~/Library/Application Support/Sublime Text 3/Packages/ - 不能嵌套子目录，也不能放成
.sublime-package文件（除非你确认该插件只提供打包版）
最容易被忽略的是：换源后不彻底重启，或者用了失效的旧博客链接（比如 php.cn 的地址在 2026 年已全部 404）；更隐蔽的是杀毒软件（火绒、360、腾讯电脑管家）会静默劫持 urllib.request 的 HTTPS 请求，导致 JSON 下载中断却不报错——临时禁用再试，比调参数管用得多。
