package control是sublime text的包管理框架而非插件；st4用户必须使用带sha256校验、哈希值以6f4c264a开头、地址为https://packagecontrol.io/的新脚本，旧脚本会静默失效。
Package Control 不是插件，是 Sublime Text 的包管理框架；没它，Ctrl+Shift+P 里根本搜不到 Install Package —— 所有“拖 zip 到 Packages 目录”或“双击安装”的做法，大概率导致命令面板卡死、菜单残留但命令不可用。
怎么确认自己该用哪个安装脚本？
打开 Help → About Sublime Text，看顶部显示的是 Sublime Text 3 还是 Sublime Text 4（2026 年主流是 ST4）。版本错一个字，脚本就静默失效：
- ST4 必须用带
hashlib.sha256校验、哈希值以6f4c264a开头、请求地址为https://packagecontrol.io/的脚本 - ST3 脚本哈希值通常以
bf11abc3或7183a2d3开头，且旧版多用http协议（现在建议强制改https） - 别复制第三方博客里带 “v3.3.1”“2022年更新” 等时间戳的代码——
packagecontrol.io页面顶部动态生成的脚本才是唯一可信来源
控制台执行后没反应、卡住、或报 CertificateError 怎么办？
这不是你粘贴错，而是网络层被拦了（TLS 握手失败、DNS 解析超时、公司/校园网屏蔽 packagecontrol.io）：
- 换手机热点最直接有效
- Mac 提示
Operation not permitted、Windows 返回空sublime.installed_packages_path()，说明系统沙盒拦截，必须切手动安装 - 别把脚本里的
https改成http——packagecontrol.io已强制重定向，反而触发更隐蔽的连接中断 - 临时调试可加
"ssl_verification": false到Preferences → Package Settings → Package Control → Settings – User，但别留着
手动安装时，Installed Packages/ 目录不能错
手动方式不是“解压 zip 到 Packages/”，而是把官方下载的 Package Control.sublime-package（注意后缀名完整！）直接拖入 Installed Packages/ 目录：
- 这个目录和
Packages/是平级的两个文件夹，搞混会导致加载失败甚至命令面板卡死 - 安装前务必进
Installed Packages/，删掉所有含Package Control字样的旧文件（包括带时间戳的备份） - 拖完必须关掉 Sublime Text 再重启，否则文件不会被重新加载
怎么验证 Package Control 真生效了？
别信 Preferences → Package Settings → Package Control 里有菜单项——那是旧版 UI 残留。真正生效只有一个硬指标：
-
Ctrl+Shift+P输入Package Control: List Packages，能弹出列表（哪怕空）才算成功 - 如果输入
Package Control后无任何补全项，说明安装未生效，需重试或检查代理配置 - 首次运行
Install Package会卡 3–8 秒——这是在拉取远程仓库索引，不是卡死；等满 15 秒仍无反应，再执行Package Control: Synchronize Packages强制刷新
最易被忽略的一点：装完 Package Control 后第一件事不是装插件，而是先运行 Package Control: Synchronize Packages。刚装好的 Package Control 默认只缓存极简元数据，不主动同步，会导致搜不到任何插件。
