Package Control失效的唯一有效验证是命令面板输入“Package Control: List Packages”无响应；需清空Installed Packages/中所有旧文件，下载https://www.php.cn/link/2e5d5f65d3ef778b01366907d1f14445并拖入该目录，重启后验证。
Package Control 不是能“更新”的插件，而是 Sublime Text 的包管理框架——它一旦安装失败或版本错配，Package Control: Install Package 命令根本不会出现在命令面板里，后续所有插件操作都会卡死。所谓“手动更新”，本质是「卸载旧版 + 重装匹配当前 Sublime Text 版本的新版」。
怎么判断 Package Control 是否真失效了
别信 Preferences → Package Settings 里有没有菜单项——那是旧残留。唯一有效验证方式是：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Package Control: List Packages - 如果命令未补全、提示
command not found，或输入后无任何响应（连“Loading…”都不出现），说明框架未加载成功 - 若弹出空列表（哪怕没装任何插件），说明已加载且联网正常
手动重装前必须清空 Installed Packages/ 目录
残留的旧版 Package Control.sublime-package 文件会干扰新版本加载，尤其常见于 ST3/ST4 混用或多次安装失败后：
- 关闭 Sublime Text
- 菜单 →
Preferences → Browse Packages…，进入打开的文件夹后，向上退一级，进Installed Packages/（不是Packages/！） - 删除该目录下所有含
Package Control字样的文件（包括Package Control.sublime-package和可能存在的Package Control.st3等） - 确认目录为空或仅剩其他插件的 .sublime-package 文件
下载并拖入正确版本的 .sublime-package 文件
2026 年当前，Sublime Text 4 用户必须使用带 SHA256 校验的最新版，URL 中的空格必须保留为 %20：
- 访问 https://www.php.cn/link/2e5d5f65d3ef778b01366907d1f14445 下载文件（注意 URL 中的
%20，不要替换成下划线或空格） - 将下载好的
Package Control.sublime-package（后缀名必须完整，不可解压、不可改名）直接拖入上一步确认的Installed Packages/目录 - 重启 Sublime Text
- 再次执行
Ctrl+Shift+P → Package Control: List Packages，看到弹窗即表示成功
为什么控制台脚本经常失败却还要优先试它
脚本失败不等于你操作错，而是网络层被拦截（TLS 握手超时、DNS 解析慢、系统沙盒拒绝写入等）。但脚本成功后，它会自动校验哈希值并写入正确路径，比手动更可靠：
- 按
Ctrl+`打开控制台，粘贴官方最新脚本：import urllib.request,os,hashlib;exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8')) - 务必等满 5 秒再看状态栏——慢网环境下提示会延迟出现
- 若报
CertificateError或URLError，或只显示reloading plugin无后续，立刻切手动方式 - macOS 提示
Operation not permitted、Windows 返回空sublime.installed_packages_path()，都是系统级拦截，手动是唯一出路
真正容易被忽略的是：Package Control 加载成功 ≠ 插件仓库能连通。首次运行 Package Control: Install Package 时卡在 “Loading packages”，大概率是 channel 请求超时，不是插件问题，而是网络策略或代理配置导致的仓库拉取失败。
