package control离线更新必须卸载旧版并重装新版,不能增量更新;需确认st4版本、完全退出程序、删除旧文件、下载180–220kb的官方sublime-package文件、拖入installed packages目录、重启后通过import package_control和list packages验证成功。

Package Control离线更新必须重装,不能“增量更新”
离线环境下,Package Control没有自动更新通道,Package Control: Upgrade Package Control 命令必然失败。所谓“更新”,本质是卸载旧版、安装新版——不是覆盖文件,而是彻底替换 Package Control.sublime-package 文件。
确认当前版本并清理旧文件
旧版本残留会导致静默冲突,尤其 ST4 用户常见旧脚本劫持现象:
- 打开控制台(
Ctrl + `),执行sublime.version(),确认返回值为4xxx - 关闭 Sublime Text(Windows 右键任务栏退出,macOS 选菜单「Quit」,不能只关窗口)
- 进入
Installed Packages/目录,删掉所有含Package Control字样的文件(包括Package Control.sublime-package和可能存在的Package Control.sublime-settings)
下载并放置新版 Package Control.sublime-package
新版必须来自官方或可信镜像,且校验文件大小:
- 从 packagecontrol.io 或国内镜像如 packagecontrol.cn 下载(注意 URL 中空格是
%20) - 检查下载文件大小:必须在
180–220 KB;若小于100 KB,说明下载不全,丢弃重试 - 将下载好的
Package Control.sublime-package文件直接拖入Installed Packages/目录,不解压、不改名、不嵌套子文件夹
重启后验证是否真正加载成功
仅命令面板出现 Package Control: Install Package 不够,需确认底层模块已导入:
- 完全重启后,打开控制台,输入
import package_control—— 若无报错,说明模块加载成功 - 运行
Package Control: List Packages,能返回空列表(而非报错或卡住)才算通过 - 若仍失败,再执行
print(sublime.installed_packages_path()),核对路径是否与你放置文件的目录一致
最易忽略的是“完全退出”和“大小写敏感的文件名”——哪怕多一个空格或错一个大写字母,Sublime 就当它不存在。











