package control装不上需先确认是否真正加载:命令面板搜不到说明未运行,应执行st4官方脚本并验证success提示或路径写入日志,彻底重启后检查settings–user中channels配置是否为https://gitee.com/.../channel_v3.json格式,同时校准系统时间、核对代理端口及手动安装文件夹命名规范。

Package Control 装不上?先确认它真在运行
按 Ctrl+Shift+P(macOS 是 Cmd+Shift+P)调出命令面板,输入 Package Control。如果完全没响应,说明它压根没装进当前 Sublime 实例——不是“慢”,是“没启动”。这时候别折腾镜像,先手动装:
菜单栏打开 View → Show Console,粘贴 ST4 官方安装代码(含 sublime.installed_packages_path() 那一版),回车执行。看到 Success 或日志里出现写入路径才算落盘;若报 URLError,直接跳到换源步骤,重试没用。
装完必须彻底重启:macOS 注意 Dock 右键选 Quit,Windows 检查任务栏进程是否清空。
Settings – User 里改 channels,不是随便填个 URL 就行
打开 Preferences → Package Settings → Package Control → Settings – User,只改这一处,别碰 Settings – Default。
填进去的地址必须满足三个硬条件:
- 协议是
https://(http://在 ST4.4+ 已被拒绝) - 结尾必须是
/channel_v3.json(不是/channel.json,v2 格式已淘汰) - 路径中必须含
/raw/master/(Gitee 的 raw 服务要求,漏了会 404)
{ "channels": [ "https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json" ] }别抄旧博客里的 php.cn 或 packagecontrol.cn 地址——它们在 2026 年已全部失效。保存后不用等“加载完成”,直接再按 Ctrl+Shift+P 输入 Package Control: Install Package,能弹出列表才算生效。
插件还是装不上?检查系统时间和镜像可用性
控制台报 ssl.CertificateError,大概率是系统时间误差超 5 分钟,SSL 握手直接失败。先校准时间,再试。
如果换源后仍卡在 “Loading…” 或列表空白,说明这个镜像在你当前网络下也不通(Gitee 有时限流)。此时有两个选择:
- 换另一个镜像,比如
https://gitee.com/kuoruan/sublime-package-control/raw/master/channel_v3.json - 跳过网络,走手动安装:去
https://packagecontrol.io/packages/插件名找 Source 链接 → 点进 GitHub →Code → Download ZIP→ 解压 → 重命名文件夹(去掉-master后缀)→ 放进Packages目录 → 重启
代理配置不是万能的,端口错一个就白设
如果你有本地代理(Clash、V2Ray 等),可以在同一份 Settings – User 里加:
{ "http_proxy": "http://127.0.0.1:7890", "https_proxy": "http://127.0.0.1:7890" }但必须核对清楚代理工具的实际监听端口——常见的是 7890、1080、8080,填错一个数字,所有请求都会静默失败。代理和镜像可以共存,但优先级是:代理生效 → 镜像地址被代理转发。所以如果代理本身不稳定,换镜像反而更干脆。
最常被忽略的点:改完 channels 不重启,或者重启了但没关干净后台进程;还有就是手动安装时文件夹命名不规范。这两处卡住的人最多,比网络问题还高频。











