package control升级本质是重装底层包管理器而非更新插件，需先清空installed packages目录中旧文件，再执行st4专用哈希值以6f4c264a开头的官网脚本，最后运行synchronize packages验证通道。
Package Control 不是普通插件，重装才是“升级”
Sublime Text 的 Package Control 本质是底层包管理器，不是你装完就能点“更新”的常规插件。当你从 ST3 升级到 ST4（2026 年绝大多数用户已是 ST4），旧版脚本会直接拒绝加载新版插件（比如 SublimeLSP 或 BracketHighlighter 的新版本），但控制台往往不报错，只表现为 Install Package 命令能调出、却搜不到任何新插件，或执行 Package Control: Synchronize Packages 后状态栏卡在“Synchronizing…”不动。
必须手动清空旧文件再重装：
- 关闭 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） - 重启后打开控制台（
Ctrl+`或Cmd+`），粘贴官网最新 ST4 脚本——务必从https://packagecontrol.io/installation页面顶部复制，哈希值必须以6f4c264a开头，地址必须是https://packagecontrol.io/
插件搜不到？先看 channel 和代理配置
重装成功 ≠ 插件列表能加载。常见静默失败原因是 channel_v3.json 下载中断，导致插件仓库无法同步。这不是 UI 显示问题，而是网络策略拦截了 HTTPS 请求。
检查并修正以下两处：
- 打开
Preferences → Package Settings → Package Control → Settings – User，确认"channels"是默认值："https://packagecontrol.io/channel_v3.json"（注意结尾是.json，不是.j或其他截断） - 如果公司/校园网有代理，需在同个 Settings – User 文件中添加：
"http_proxy": "http://your-proxy:port"或"https_proxy": "http://your-proxy:port"，否则即使脚本执行成功，也会卡在同步环节
手动安装插件时路径和命名不能错
手动安装（比如 GitHub 下载的 zip）容易因路径或命名不规范导致插件不生效。Sublime 不会报错，只是默默忽略。
关键规则：
- 解压后，插件文件夹名必须与插件主文件夹名一致（例如
MarkdownPreview文件夹里必须包含MarkdownPreview.py或main.py，且文件夹名不能是markdown-preview-master或带数字后缀） - 必须放到
Packages目录下（不是Installed Packages），路径为：Packages/插件名/（Windows：%APPDATA%\Sublime Text\Packages\；macOS：~/Library/Application Support/Sublime Text/Packages/） - 不要把多个插件塞进同一个文件夹，也不要保留原始 zip 或
__MACOSX隐藏目录
升级失败别怪脚本，先查残留和网络
90% 的 Package Control 升级失败，根源不在脚本本身，而在两个地方：一是 Installed Packages 目录里没清干净旧文件，二是本地网络策略（如防火墙、DNS 污染、HTTPS 中间人）拦截了 https://packagecontrol.io/channel_v3.json 的请求。
验证方式很直接：
- 用浏览器访问
https://packagecontrol.io/channel_v3.json，能打开说明通道通；打不开就说明是网络问题，不是 Sublime 的锅 - 升级后执行
Package Control: Synchronize Packages，若状态栏显示“Synchronizing packages”并 5 秒内完成，说明通道已通；若一直转圈或无反应，大概率是 channel 配置错误或代理未设
真正麻烦的是那些“看起来装上了但功能不对”的情况——比如 Emmet 不能展开缩写，或 AutoFileName 不提示路径。这类问题通常不是 Package Control 的事，而是插件自身兼容性或快捷键冲突，得单独排查。
