package control升级本质是重装管理器而非更新插件，需先清空installed packages目录中旧文件，再执行st4专用哈希值以6f4c264a开头的官网脚本，最后运行synchronize packages验证通道；失败主因是残留文件或网络拦截，非脚本问题。
Package Control 升级不是“更新插件”，而是重装管理器本身
Package Control 不是普通插件，它属于 Sublime Text 的底层包管理基础设施。所谓“升级”，本质是卸载旧版、安装新版脚本——尤其当你要用 ST4 运行依赖新 API 的插件（比如支持 LSP 1.2+ 的 SublimeLSP）时，旧版 Package Control（如 ST3 脚本）会静默拒绝加载这些包。
常见错误现象：Install Package 命令存在但搜不到新插件；控制台报 channel_v3.json not found 或直接空白；Package Control: Synchronize Packages 执行后无响应。
- 必须先确认当前 Sublime 版本：Help → About Sublime Text，明确显示
Sublime Text 4（2026 年绝大多数用户已是 ST4） - ST4 必须用哈希值以
6f4c264a开头、且请求地址为https://packagecontrol.io/的脚本 —— 复制第三方博客里带“v3.3.1”“2022 年”字样的代码大概率失效 - 不要尝试“覆盖安装”：旧版残留的
Package Control.sublime-package文件会干扰新版初始化，需手动清理
安全升级三步操作：清空 + 换脚本 + 验证通道
升级失败多数源于残留或网络层拦截，而非脚本本身问题。按顺序执行以下动作：
- 关闭 Sublime Text
- 进入
Installed Packages目录（Windows：%APPDATA%\Sublime Text\Installed Packages；macOS：~/Library/Application Support/Sublime Text/Installed Packages；Linux：~/.config/sublime-text/Installed Packages），删除所有含Package Control字样的文件（通常只有Package Control.sublime-package） - 重新打开 Sublime，按
Ctrl+`（或Cmd+`）打开控制台，粘贴官网最新 ST4 脚本（务必从https://packagecontrol.io/installation页面顶部复制，非存档链接） - 执行后等待几秒，无报错即表示写入成功；重启编辑器，再按
Ctrl+Shift+P输入Package Control: Synchronize Packages—— 成功则状态栏显示Synchronizing packages...并在 5 秒内完成
升级后插件仍不可见？检查 channel 和代理配置
即使 Package Control 重装成功，插件列表加载失败往往卡在 channel 同步环节。这不是 UI 问题，而是网络策略导致的静默失败。
- 打开
Preferences → Package Settings → Package Control → Settings – User，确认"channels"是默认值："https://packagecontrol.io/channel_v3.json" - 若公司/校园网限制访问，需手动添加代理：
"https_proxy": "http://127.0.0.1:8080"（按你本地代理端口填） - Mac/Linux 用户 OpenSSL 版本过低时，临时加
"ssl_verification": false（仅调试用，切勿长期保留） - hosts 文件中若有
packagecontrol.io重定向行，必须删除；执行ping packagecontrol.io确认 DNS 可解析
高版本插件依赖的隐藏条件：Python 3.14+ 运行时
部分新插件（如 Terminus 2.0+、LSP-pyright）要求 Sublime Text 内置 Python 运行时 ≥ 3.14。ST4 默认带 Python 3.14.3，但若你手动降级过或使用非官方构建版，可能不满足。
验证方式：打开控制台，输入 import sys; print(sys.version)，输出应为 3.14.x。若低于此版本，插件虽能安装，但启动时会报 ImportError: cannot import name '...' from 'typing' 类错误，且不会提示具体原因。
这个点容易被忽略：Package Control 装得再干净，底层 Python 不匹配，插件照样瘫痪。别急着重装，先看版本。
