Sublime Text插件安装失败主因是Package Control无法访问被屏蔽的官方源，需手动安装、校准时间、切换Gitee镜像源（含/raw/master/路径）、配置代理或手动放入Packages目录。
插件安装卡在“Installing 1 package”或命令面板空白，基本就是 Package Control 拉不到 channel_v3.json —— 不是 Sublime 有问题，是它默认连的 packagecontrol.io 和 raw.githubusercontent.com 在国内被限。
确认 Package Control 已正确安装
很多“装不慢”其实是压根没装上。按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入 Package Control，如果完全无响应，说明没装进运行时环境。此时必须手动安装：
- 打开
View → Show Console，粘贴 ST4 官方手动安装代码（含sublime.installed_packages_path()调用的那一版），回车执行 - 看到
Success或日志里出现写入路径才算落盘成功；若报URLError或超时，别重试，直接切到换源步骤 - 装完必须彻底重启 Sublime（macOS 注意 Dock 右键 Quit，Windows 检查任务栏进程），再搜
Install Package能出来才算生效 - 系统时间误差超过 5 分钟会导致 SSL 验证失败，控制台报
ssl.CertificateError时先校准系统时间
改用 Gitee 镜像源（最稳、最快）
官方源失效后，社区维护的 Gitee 镜像最可靠，但必须用对地址和格式：
- 打开
Preferences → Package Settings → Package Control → Settings – User - 填入完整 HTTPS URL，结尾必须是
/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 继承，必须显式声明：
- 在
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 的urllib不支持 - 设完别急着试插件，先在控制台运行：
import urllib.request; urllib.request.urlopen('https://packagecontrol.io').getcode()，返回200才算真正通了
手动安装插件（网络极差时的兜底方案）
跳过 Package Control 的在线链路，直接把插件放进目录：
- 去插件 GitHub 主页（如
https://github.com/facelessuser/BracketHighlighter），点Code → Download ZIP，不要git clone - 关闭并彻底退出 Sublime，再重新启动
- 解压 ZIP 后得到一个文件夹，整体拖进
Packages目录（通过Preferences → Browse Packages…打开）——注意不是Installed Packages，也不是嵌套子目录 - 插件名若出现在
ignored_packages列表里（检查用户设置），会被静默屏蔽，需手动移除 - Sublime Text 4 已弃用 Python 2 插件，若插件最后更新在 2018 年前且无
python3标签，控制台大概率报ImportError或invalid syntax
真正卡住的地方往往不是“要不要换源”，而是镜像 URL 少写了 /raw/master/、代理端口填错、或者没彻底退出 Sublime 就去放文件——这些细节不处理，换十次源也没用。
