package control 是 sublime text 的包管理框架而非插件,必须通过官方 sha256 校验脚本(st4 专用)或手动拖放 .sublime-package 文件至 installed packages/ 目录安装,成功标志是 ctrl+shift+p 中可执行 package control: list packages 并返回列表。

Package Control 不是插件,是 Sublime Text 的包管理框架。没它,Ctrl+Shift+P 里根本搜不到 Install Package,所有插件安装都会卡死或失效。
控制台执行官方脚本(首选,但只在能连通 packagecontrol.io 时有效)
这是唯一被 Sublime 官方文档明确推荐的方式,ST4(2026 年主流版本)必须用带 SHA256 校验的最新脚本,旧版会静默失败。
- 按
Ctrl+`打开控制台,**一次性粘贴整段代码**,回车执行: import urllib.request,os,hashlib; h = '6f4c264a24d933ce70df5dedcf1dcaee' + 'ebe013ee18cced0ef93d5f746d80ef60'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); by = urllib.request.urlopen('https://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download (got %s instead of %s)' % (dh, h)) if dh != h else open(os.path.join(ipp, pf), 'wb').write(by)- 关键判断依据不是“无报错”,而是左下角状态栏出现
Package Control: Successfully installed Package Control - 若只显示
reloading plugin或空白,等满 5 秒再确认——多数失败是 TLS 握手超时,不是脚本写错 - 别复制网页上带
st3或st4字样的旧脚本,那些在当前 ST4 已失效
手动拖放 .sublime-package 文件(网络/代理/系统权限受限时必选)
当控制台报 CertificateError、URLError、macOS 提示 Operation not permitted,或 Windows 下 sublime.installed_packages_path() 返回空路径,说明脚本被拦截,必须切手动方式。
- 关闭 Sublime Text
- 菜单 →
Preferences → Browse Packages…→ 向上退一级,进入Installed Packages/目录(不是Packages/) - 下载官方文件:
https://packagecontrol.io/Package%20Control.sublime-package(注意 URL 中空格已编码) - 把下载好的
Package Control.sublime-package文件**直接拖入**Installed Packages/,**不要解压、不要改名、不要放进 Packages/** - 清空该目录下所有含
Package Control字样的旧文件,避免加载冲突
验证是否真正生效(别信“看起来有”)
很多人看到 Preferences → Package Settings 里有菜单就以为成功了,那是旧版残留 UI,完全不可靠。
- 重启 Sublime Text 后,按
Ctrl+Shift+P,输入Package Control: List Packages - 如果弹出一个列表(哪怕为空),说明
Package Control已加载并联网成功 - 如果提示
command not found,或输入Package Control后无任何补全,说明安装失败,需重试 - 首次运行
Package Control: Install Package时,左下角应显示Fetching channel—— 这才是真活了
装完就卡住、没反应、或提示 timeout 的常见原因
这不是插件问题,是 Package Control 自身在拉取元数据时被阻断。
- 检查
Preferences → Package Settings → Package Control → Settings – User,确认"channels"是默认值:"https://packagecontrol.io/channel_v3.json",别拼错域名或误写成http - 公司内网需显式配置代理:
"http_proxy": "http://127.0.0.1:8080"和"https_proxy": "http://127.0.0.1:8080",系统代理不会自动继承 - Mac/Linux 遇到 SSL 错误可临时加
"ssl_verification": false(仅调试用,不长期开启) - 执行
Package Control: Synchronize Packages比重启更有效,能强制刷新缓存的 channel
真正的难点不在“怎么装”,而在于区分“脚本执行了”和“框架加载了”。很多用户反复重装,其实只是在重复同一个失败环节——只要 Package Control: List Packages 不返回列表,就等于没装成,得从网络策略或目录路径重新排查。











