package control是sublime text的包管理框架而非插件；st4用户必须用packagecontrol.io动态生成的带hashlib.sha256校验的新脚本安装，旧脚本会静默失效，装完需清残留、重启并验证package control: list packages命令可用。
Package Control 不是插件，是 Sublime Text 的包管理框架；没它，Ctrl+Shift+P 里根本搜不到 Package Control: Install Package，所有后续插件安装都会卡死在第一步。
怎么确认该用哪个安装脚本？
打开 Help → About Sublime Text，看顶部显示的是 Sublime Text 4 还是 Sublime Text 3。2026 年绝大多数人用的是 ST4，必须用带 hashlib.sha256 校验的新脚本；ST3 用户若误粘 ST4 脚本，会报 module 'urllib' has no attribute 'request'。
- ST4 推荐命令（唯一可信来源是 packagecontrol.io 页面顶部动态生成）：
import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://www.php.cn/link/05d446b21e401cdc44ea5ddb67ff0031installation.py').read().decode('utf-8')) - 别复制第三方博客里带 “st3”“st4”“v3.3.1” 或 “2022 年更新” 字样的代码——那些在当前 ST4 已静默失效
- 执行前先清空
Installed Packages/目录下所有含Package Control字样的旧文件，避免加载冲突
控制台执行后没反应或报错怎么办？
常见现象不是你操作错了，而是网络层被拦了：DNS 解析慢、TLS 握手超时、系统沙盒拦截，或公司/校园网屏蔽 packagecontrol.io。
-
CertificateError或URLError：说明 HTTPS 请求失败，别改https为http（已强制重定向，反而触发更隐蔽中断） - 黑屏几秒后只显示
reloading plugin：等满 5 秒再看状态栏是否出现Package Control: Successfully installed Package Control - macOS 提示
Operation not permitted，Windows 下sublime.installed_packages_path()返回空：系统权限拦截写入，手动安装是唯一出路
手动安装 Package Control 的三处关键细节
手动不是“解压 zip 到 Packages/”，而是把官方 .sublime-package 文件原样拖进 Installed Packages/ 目录。
- 下载地址必须是：
https://www.php.cn/link/05d446b21e401cdc44ea5ddb67ff0031Package%20Control.sublime-package（注意空格编码为%20，不要手动替换成下划线或删掉） - 关闭 Sublime Text 后，通过菜单
Preferences → Browse Packages…，向上退一级进入同级的Installed Packages/目录（不是Packages/！） - 把下载好的
Package Control.sublime-package文件（后缀名必须完整保留）直接拖进去，**不要解压、不要改名、不要放进Packages/** - 拖完必须重启 Sublime Text，否则插件加载器根本不扫描它
怎么验证 Package Control 真生效了？
别信菜单里突然多出的 Preferences → Package Settings → Package Control ——那是旧版残留 UI。真正生效的表现只有一个：
- 重启后按
Ctrl+Shift+P，输入Package Control: List Packages，能弹出一个列表（哪怕空） - 再输入
Package Control: Install Package回车，状态栏出现Fetching list of available packages - 首次拉取通常要 5–10 秒，这是在同步远程仓库索引，不是卡死
- 如果输入后无任何补全项，或提示
command not found，说明安装未生效，需重试或检查代理配置
最常被忽略的是：装完之后不运行 Package Control: Synchronize Packages，导致本地缓存为空，搜不到任何插件——这步不能跳过。
