package control 卡在“installing 1 package”是因国内无法访问 packagecontrol.io 和 raw.githubusercontent.com 导致 channel_v3.json 下载失败；需重装插件、校准系统时间、切换 gitee 镜像源（url 必须含 /raw/master/channel_v3.json）、配置正确代理（http://127.0.0.1:7890）、或手动安装 zip 并重命名拖入 packages 目录，且每次修改后必须彻底重启 sublime 并用 urllib 测试连通性。
Package Control 卡在 “Installing 1 package” 怎么办
这不是 Sublime 本身的问题，而是 packagecontrol.io 和 raw.githubusercontent.com 在国内访问受限，导致 channel_v3.json 下载失败或超时。命令面板里一直转圈、控制台报 Operation timed out (errno 12002) 或 ssl.CertificateError，基本可以锁定是源不可达。
- 先确认 Package Control 真的装好了：按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Package Control，看是否有下拉选项；没反应说明没成功加载，得重装 - 重装必须用官方最新手动安装脚本（ST4 对应版本），粘贴到
View → Show Console执行，看到Success或日志里出现sublime.installed_packages_path()路径才算落盘 - 装完必须彻底退出再重开——macOS 别只关窗口，要右键 Dock 图标选
Quit；Windows 要在任务管理器里确认sublime_text.exe进程已结束 - 系统时间误差超过 5 分钟会导致 SSL 验证失败，控制台报
ssl.CertificateError时，先校准系统时间
换 Gitee 镜像源的具体操作和常见坑
最稳的方式是把 channels 指向社区维护的 Gitee 镜像，但 URL 格式错一个字符就白配。
- 打开
Preferences → Package Settings → Package Control → Settings – User - 填入完整 HTTPS 地址，结尾必须是
/channel_v3.json，且路径中含/raw/master/，例如："https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json" - 别用博客里抄的旧链接（比如 php.cn 的地址在 2026 年已全部 404）；也别误用
channel.json（那是 v2 格式，与当前 Package Control 不兼容） - 保存后必须重启 Sublime，再调出命令面板输入
Package Control: Install Package，能列出插件名才算生效
配置代理时端口和协议写错就等于没配
Clash、V2Ray 等工具不会自动被 Sublime 继承，必须显式声明，且 Sublime 的 urllib 对代理格式很敏感。
- 在
Package Control → Settings – User中添加："http_proxy": "http://127.0.0.1:7890"和"https_proxy": "http://127.0.0.1:7890" - 端口必须与你本地代理实际监听端口一致（Clash 默认是
7890，但部分配置可能为7891或8080） - 协议必须用
http://，即使目标是 HTTPS 站点；不能带认证信息（如user:pass@），Sublime 不支持 - 设完别急着试插件，先在控制台运行：
import urllib.request; urllib.request.urlopen('https://packagecontrol.io').getcode()，返回200才算真正通了
手动安装插件时路径和命名不对就白忙活
这是绕过网络瓶颈最可靠的方式，但细节错一点，插件就压根不加载。
- 去插件 GitHub 主页（比如
https://github.com/facelessuser/BracketHighlighter），点Code → Download ZIP，不要用git clone - 解压后，把文件夹重命名为干净名称（如把
BracketHighlighter-master改成BracketHighlighter），确保不含空格、中文或特殊符号 - 打开
Preferences → Browse Packages…，把重命名后的文件夹拖进弹出的Packages目录（不是Installed Packages！） - 关闭并彻底退出 Sublime，再重新启动；如果插件不生效，打开控制台（
Ctrl + `）看有没有ImportError或invalid syntax
urlopen 测试——不验证，你永远不知道代理到底通没通。
