Package Control是Sublime Text的包管理框架而非插件;必须根据Help→About显示的ST3或ST4版本选择对应脚本(ST4用哈希以6f4c264a开头、地址为https://packagecontrol.io/的脚本),执行后重启并验证Ctrl+Shift+P可调出Package Control: List Packages和Install Package命令才算成功。

Package Control 不是插件,是 Sublime Text 的包管理框架;没它,Ctrl+Shift+P 里根本搜不到 Install Package——所有“装了插件不生效”的问题,八成卡在这一步。
怎么确认该用哪个安装脚本?
打开 Help → About Sublime Text,看顶部显示的是 Sublime Text 3 还是 Sublime Text 4。别猜,版本错一个字,脚本就静默失效:
-
Sublime Text 4(2026 年主流)必须用哈希以6f4c264a开头、请求地址为https://packagecontrol.io/的脚本; -
Sublime Text 3脚本哈希通常以bf11abc3或7183a2d3开头,且旧版多走 HTTP(现在已强制重定向 HTTPS,手动改http://反而触发连接中断); - 别复制第三方博客里带 “v3.3.1”“2022 年更新” 等时间戳的代码——
https://packagecontrol.io/页面顶部动态生成的脚本才是唯一可信来源。
控制台执行失败后怎么办?
粘贴脚本后只显示 reloading plugin 或无反应?不是手速问题,而是 TLS 握手失败、DNS 解析超时或系统沙盒拦截:
- macOS 提示
Operation not permitted,Windows 下sublime.installed_packages_path()返回空,或报CertificateError/URLError,说明 HTTPS 请求被策略拦截; - 此时必须切手动安装,且三处不能错:
• 先在控制台执行sublime.installed_packages_path()查真实路径(ST4 默认是Sublime Text/Installed Packages,不是Sublime Text 4/);
• 下载地址必须是https://packagecontrol.io/Package%20Control.sublime-package(注意空格编码为%20);
• 文件名必须严格为Package Control.sublime-package,不能解压、不能改后缀、不能加数字或下划线;
• 扔进Installed Packages/后必须重启 Sublime,否则插件加载器根本不扫描它。
怎么验证 Package Control 真生效了?
别信菜单里突然多出的 Preferences → Package Settings → Package Control——那是旧版残留 UI。真正生效的表现只有一个:
- 重启后按
Ctrl+Shift+P,输入Package Control: List Packages,能弹出一个列表(哪怕空); - 再输入
Install Package回车,状态栏出现Fetching list of available packages; - 首次拉取通常要 5–10 秒,这是在同步远程仓库索引,不是卡死。
很多人卡在第一次 Install Package 没反应,其实是没等够那几秒——Package Control 默认不预加载仓库,首次调用才去拉元数据,这个延迟是设计行为,不是故障。


















