Package Control是Sublime Text的包管理框架而非普通插件,必须通过官方Python脚本安装;Sublime Text 4需用带SHA256校验的新脚本,执行后左下角提示“Installed X packages”且命令面板可调出“List Packages”才算成功,手动安装须将.sublime-package文件拖入Installed Packages目录不改名不解压。

Package Control 不是普通插件,它是 Sublime Text 的包管理框架。没它,Ctrl+Shift+P 里根本搜不到 Install Package —— 所有“下载 zip 解压到 Packages 目录”或“拖 .sublime-package 文件进去”的做法,大概率导致命令面板卡死、菜单项残留但命令不可用。
直接执行控制台脚本是唯一可靠方式
Sublime Text 4(2026 年主流版本)必须用带完整 SHA256 校验的新脚本,旧版会卡在 Installing Package Control 状态不动。别复制网页上带 st3 或 st4 字样的旧链接,那些已失效。
- 按
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))ifdh != helseopen(os.path.join(ipp, pf),'wb').write(by)- 执行后等满 5 秒再判断:控制台末尾为空行 + 左下角弹出
Package Control: Installed X packages(或类似成功提示),才算真成功 - 若报
CertificateError或URLError,不是脚本问题,而是系统/代理拦截了 HTTPS 请求;此时别改脚本里的https为http——packagecontrol.io已强制重定向,反而触发更隐蔽的连接中断
安装后验证失败的常见原因
很多人看到 Preferences → Package Settings 里有 Package Control 菜单项就以为装成了,其实那是旧版残留。真生效只有一个标准:
- 重启 Sublime Text 后,按
Ctrl+Shift+P,输入Package Control: List Packages - 如果弹出空列表(哪怕 0 个包),说明已加载并联网成功
- 若提示
command not found,或输入Package Control后无任何补全,说明安装失败 - 首次运行
Package Control: Install Package会卡几秒——这是在拉取远程仓库索引,不是卡死,别急着关面板
网络受限时的手动安装路径
macOS 提示 Operation not permitted、Windows 返回空 sublime.installed_packages_path()、控制台报 SSL 错误,都说明脚本被系统策略或网络沙盒拦截。这时必须切手动方式,且不能乱放文件:
- 访问
https://packagecontrol.io/Package%20Control.sublime-package下载该文件(注意 URL 中空格已编码为%20) - 通过菜单
Preferences → Browse Packages打开Installed Packages目录 - 把下载好的
Package Control.sublime-package文件直接拖入该目录(不要解压、不要改名、不要放进子文件夹) - 重启 Sublime Text,再验证
Package Control: List Packages是否可执行
装完第一件事:同步仓库 + 安装中文支持
刚装好的 Package Control 默认只缓存极简元数据,不立刻同步仓库,会导致搜不到插件。原生界面是英文,中文用户容易误判功能位置:
- 先运行
Package Control: Synchronize Packages,强制刷新本地仓库缓存 - 再运行
Package Control: Install Package,搜ChineseLocalizations并安装 - 配置代理需写进
Preferences → Package Settings → Package Control → Settings – User,加字段"http_proxy"和"https_proxy",格式如"http://127.0.0.1:8080" - 别信
"ssl_verification": false这种临时开关——它能绕过证书错误,但会让后续插件更新暴露在中间人攻击下
最常被忽略的是:首次 Install Package 卡住不是失败,而是正在后台并发请求上百个插件的元数据;只要状态栏没报错、命令面板没崩溃,等够 10 秒再操作。











