package control是sublime text的包管理框架而非插件中心或普通插件;必须根据help→about中显示的st3或st4版本选择对应脚本安装,st4须用哈希以6f4c264a开头且地址为https://packagecontrol.io/的脚本,版本错则install package选项不出现。

Package Control 不是插件中心,也不是普通插件——它是 Sublime Text 的包管理框架。没它,Ctrl+Shift+P 里根本搜不到 Install Package,所有插件安装都无从谈起。
怎么确认自己该用哪个安装脚本
打开 Sublime Text → Help → About Sublime Text,看顶部显示的是 Sublime Text 4 还是 Sublime Text 3。2026 年绝大多数用户用的是 ST4,但版本错一个字,脚本就静默失效:
- ST4 必须用哈希值以
6f4c264a开头、请求地址为https://packagecontrol.io/的脚本 - ST3 脚本哈希通常以
bf11abc3或7183a2d3开头,且旧版多用http(现在建议强制改https) - 别复制第三方博客里带 “v3.3.1”“2022年更新” 等时间戳的代码——
packagecontrol.io页面顶部动态生成的脚本才是唯一可信来源
控制台执行后没反应或报 ssl.SSLCertVerificationError
这不是粘贴错了,而是网络层被拦了。常见于公司网、校园网、Mac 沙盒或老旧 OpenSSL:
- 在
Preferences → Package Settings → Package Control → Settings – User中手动加字段:"https_proxy": "http://127.0.0.1:8080"(按你本地代理填) - Mac/Linux 用户 OpenSSL 太老:临时加
"ssl_verification": false(仅调试,别留着) -
hosts文件重定向过packagecontrol.io:删掉相关行,ping packagecontrol.io确认能通 - 脚本里地址写的是
http://却被防火墙拦截:把脚本中所有'http://packagecontrol.io/'替换成'https://packagecontrol.io/'再粘贴
装完为什么 Install Package 搜不到插件
不是插件源没加载,而是 Package Control 默认首次运行时才拉取 channel 列表——这个过程不提示、不报错、不弹窗:
- 按
Ctrl+Shift+P→ 输入Install Package→ 回车 → 光标变空转圈状态,这是正常现象;等 3–8 秒,列表才会出来 - 等满 15 秒还是空,执行
Package Control: Synchronize Packages强制刷新,比重启 Sublime 有效得多 - 检查
Settings – User里"channels"是否为默认值:"https://packagecontrol.io/channel_v3.json" - 插件名大小写敏感:输
emmet没结果,但输Emmet就有——得按插件 GitHub 仓库名来
手动安装失败的三个致命细节
手动方式只在脚本彻底失败时启用,但三处极易出错,错一处就白忙:
- 必须把官方下载的
Package Control.sublime-package(注意后缀名完整)直接拖入Installed Packages/目录,不是Packages/——这两个目录平级,搞混会导致命令面板卡死 - 拖入前先清空
Installed Packages/下所有含Package Control字样的文件,否则旧版残留会干扰加载 - 拖完必须关掉 Sublime Text 再重启,不能热重载;验证唯一标准是
Ctrl+Shift+P输入Package Control: List Packages能弹出空列表(哪怕 0 个包)
最常被忽略的是:首次运行 Install Package 后那几秒的“无声等待”——既没进度条也没提示,但后台正在拉取整个 channel_v3.json,国内用户常在这一步误判为卡死而强行关闭面板。其实只要左下角出现 Fetching list of available packages,就说明管道已通,只需多等几秒。











