package control命令面板搜不到说明其未加载进运行时,需验证st版本、检查installed packages/目录是否存在package control.sublime-package文件并清除旧包,哈希校验失败须重复制官网最新脚本,channel不可达则需更换镜像源并完全重启。

Package Control命令面板搜不到
说明它根本没加载进 Sublime 运行时,不是“装了没反应”,而是“压根没进来”。先别重装,快速验证三件事:
- 按
Ctrl+`打开控制台,输入sublime.version()看返回值:4xxx 是 ST4,3xxx 是 ST3;版本错配会导致脚本静默失败 - 再输
sublime.installed_packages_path(),去文件系统里打开该路径下的Installed Packages/目录,确认是否存在Package Control.sublime-package - 如果文件存在但命令仍不出现,大概率是残留旧包干扰:删掉
Installed Packages/下所有含Package Control字样的文件(包括Package Control (old).sublime-package),再重跑官网最新脚本
注意:Packages/ 目录 ≠ Installed Packages/ 目录——把 .sublime-package 文件丢进 Packages/,Sublime 会彻底无视它。
控制台执行安装脚本后报 Error validating download
这是哈希校验失败,不是网络不通,而是下载下来的文件和脚本里预设的 h 值不一致。常见原因有两个:
- 从网页、PDF 或截图复制了带不可见字符(如全角空格、零宽字符)的脚本,粘贴进控制台后 Python 解析出错
- 脚本过期:ST4(
sublime.version()≥ 4126)必须用含urllib.request和hashlib.sha256的新版;ST3 必须匹配当前官网页面所列的哈希值(例如h = '7183a2d3e96f11eeadd761d777e62404')
别手动改 h 值——它由官网动态生成,改了也没用。直接刷新 https://www.php.cn/link/befa130dcb31961fa251d61e1e6ba0e1 页面,重新复制整段 “Manual Installation” 区块下的代码。粘贴前先清空控制台,整行粘贴,不要分段回车。
装上了却提示 “There are no packages available”
这不是 Package Control 没装好,是它的插件列表地址(channel)根本没通。国内用户十有八九卡在这步,因为默认的 https://packagecontrol.io/channel_v3.json 在 DNS、TLS 握手、CDN 层面都极不稳定。
- 浏览器直接访问你配置的
channelURL,必须能返回完整 JSON 内容才算有效(注意结尾必须是/channel_v3.json,不是/channel.json) - 推荐使用 Gitee 镜像:
https://gitee.com/akira-cn/package_control_channel/raw/master/channel_v3.json,填入Preferences → Package Settings → Package Control → Settings – User - 填完必须完全退出 Sublime(macOS 右键 Dock 图标选 Quit,Windows 右键任务栏图标选退出),再重启;设置不热重载
若仍为空,执行 Package Control: Synchronize Packages 强制刷新缓存;无效则手动删掉 Package Control.cache/ 目录下的 channel_v3.json 和 channel_v3.json.last-modified 文件。
开了 Clash/Surge 却还是连不上
Sublime 的 urllib.request 不继承系统代理,Clash 默认监听 127.0.0.1:7890,但它根本不会去读这个端口。
- 在
Package Control Settings – User中加两行:"http_proxy": "http://127.0.0.1:7890"和"https_proxy": "http://127.0.0.1:7890" - 协议必须小写,
HTTP或HTTPS全大写会失败 - 端口要和你 Clash 实际监听端口一致(常见还有
1080、1081)
代理配置生效的前提是 Package Control 已正确安装并加载——如果命令面板都搜不到,先解决前面三步,再配代理。否则只是给一个不存在的服务加转发规则。











