package control离线安装必须将.sublime-package文件放入installed packages目录,不可解压或放错路径;windows、macos、linux路径各异,需完全重启sublime才生效,且代理或镜像配置须显式设置并重启生效。

Package Control 装不上,八成不是它坏了,而是网络链路在初始化阶段就断了——离线安装比修代理更快、更稳。
Package Control 离线安装必须放对路径
手动下载的 Package Control.sublime-package 文件不能扔进 Packages/ 目录,那是给源码插件用的;必须拖进 Installed Packages/ 目录,且不许解压。路径错了,Sublime 根本不会加载它。
- Windows 路径:
%APPDATA%\Sublime Text 3\Installed Packages\(ST4 同理,只是文件夹名可能含 “4”) - macOS 路径:
~/Library/Application Support/Sublime Text 3/Installed Packages/ - Linux 路径:
~/.config/sublime-text-3/Installed Packages/ - 放进后必须完全退出 Sublime(macOS 要右键 Dock 图标选 Quit),再重开,否则不生效
代理配置只认 http:// 格式,不走系统代理
Sublime 的 Package Control 默认无视系统代理设置,http_proxy 和 https_proxy 字段必须显式填在 Package Control.sublime-settings 里,且协议头只能是 http://,写成 https:// 或省略协议会静默失效。
- Clash/V2RayN/Surge 的 HTTP 端口通常是
127.0.0.1:7890,直接填这个就行 - SOCKS5 地址如
127.0.0.1:1080不支持,得换工具的 HTTP 模式,或启用转发 - 需要认证才填
proxy_username和proxy_password;本地代理多数留空即可 - JSON 最后一项后不能有多余逗号,否则整个配置被忽略
ssl_verification 和 pcgpg_disable_verify 是两回事
报错里有 GPG signature verification failed?关掉 ssl_verification 没用,那只是跳过 HTTPS 证书校验;真正卡住的是 GPG 签名验证环节,必须设 "pcgpg_disable_verify": true 才能绕过。
-
"ssl_verification": false→ 解决 TLS 握手失败、企业中间人代理报错 -
"pcgpg_disable_verify": true→ 解决密钥过期、GPG 公钥拉不到、签名验证中断 - 两者可共存,但别只改一个还指望问题消失
- 国内用户更推荐直接换镜像源,比关校验更安全:填
"channels": ["https://gitee.com/akira-cn/package_control_channel/raw/master/channel_v3.json"]
最常被忽略的点:改完任何配置都必须重启 Sublime,Settings 不热重载;而 channel_v3.json 拉不到,就会一直显示 “There are no packages available”,哪怕 Package Control 本身已装好。











