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 秒，这是在同步远程仓库索引，不是卡死；
- 如果一直无声无息，关掉 Sublime，删掉 Cache/ 和 Packages/0_package_control_loader/（如有），再重启重试。
装完之后第一件事不是装插件，而是同步仓库
刚装好的 Package Control 默认只缓存极简元数据，不立刻同步仓库，会导致搜不到插件：
- 先运行 Package Control: Synchronize Packages，强制刷新本地仓库缓存；
- 再运行 Package Control: Install Package，搜 ChineseLocalization 装中文支持（原生界面是英文，容易误判功能位置）；
- 首次使用 Install Package 时光标转圈是正常现象，等满 3–8 秒，列表才会出来——这个延迟常被当成失败，其实只是网络层在拉索引。
最常被忽略的点：手动安装时把 Package Control.sublime-package 错扔进 Packages/ 目录（而不是同级的 Installed Packages/），会导致命令面板卡死、Install Package 命令彻底消失，且残留文件干扰极强——删干净再重来。
