package control.cache 损坏会导致插件无法更新或安装、命令面板搜不到新插件、显示 “there are no packages”,需彻底退出 sublime 后删除 packages/user/package control.cache/ 下的 channel_v3.json、channel_v3.json.last-modified 及所有 *.cache 文件,并手动执行 package control: synchronize packages 才能恢复。

Package Control.cache 损坏会导致插件无法更新或安装
插件装不上、命令面板搜不到新插件、Package Control: Install Package 显示 “There are no packages”,大概率是 channel_v3.json 或其配套缓存损坏了。这不是网络问题,而是本地缓存校验失败后,Package Control 直接拒绝加载任何插件列表。
-
channel_v3.json若为空、过期或 MD5 校验不通过,就会卡住整个插件生态 - 真正缓存路径在
Packages/User/Package Control.cache/,不是Cache/或Installed Packages/ - 必须连带删掉同目录下的
channel_v3.json.last-modified和所有*.cache文件,只删channel_v3.json不够 - 删之前务必彻底退出 Sublime:Windows 用任务管理器确认
sublime_text.exe全部消失;macOS 用活动监视器强制退出;Linux 执行pkill -f "sublime_text"
删完缓存后必须手动触发 Synchronize Packages
清空 Package Control.cache/ 目录只是“擦黑板”,Sublime 不会自动重拉 channel 数据。不执行同步,重启后依然显示空列表或旧错误。
- 重启 Sublime 后,按
Ctrl + Shift + P(Win/Linux)或Cmd + Shift + P(macOS) - 输入
Package Control: Synchronize Packages并回车(注意不是Install Package) - 等右下角出现
Finished synchronizing packages才算成功;若卡在Synchronizing…,说明 DNS 或代理有问题,不是缓存没清干净 - 同步失败时控制台会报
URLError: <urlopen error name or service not known></urlopen>,这时要查网络,不是继续删文件
插件卸载后残留配置和缓存仍在吃 CPU
用 Package Control: Remove Package 只删了主代码,但 Packages/User/ 下的配置、Cache/ 下的语言服务器索引、Local/ 中的 UI 状态全留着——所以右键菜单还能看到 “Format with Black”,点开就报错;pyright 进程还在后台跑,CPU 持续 100%。
- 去
Packages/User/搜索插件名,删掉所有PluginName.sublime-settings和PluginName.sublime-commands - 进系统级
Cache路径(如 Windows 的%LOCALAPPDATA%\Sublime Text\Cache),用文件名搜索pyright、texlab、lsp,整文件夹删除 - 检查
Packages/User/Default (Windows).sublime-keymap等 keymap 文件,删掉含该插件命令的整段 JSON - 别漏掉
Package Control.sublime-settings—— 它若存在且含"sync_login",首次启动就会从云端恢复全部插件
不同版本 Sublime 的缓存路径不能混删
Sublime Text 3 和 Sublime Text 4 的用户数据目录**完全独立**。删了 %APPDATA%\Sublime Text(v4 默认路径),却漏掉 %APPDATA%\Sublime Text 3,重装 v3 后所有插件、设置、LSP 缓存原样复活。
- Windows v3 路径:
%APPDATA%\Sublime Text 3和%LOCALAPPDATA%\Sublime Text 3 - macOS v3 路径:
~/Library/Application Support/Sublime Text 3和~/Library/Caches/com.sublimetext.3 - Linux v3 路径:
~/.config/sublime-text-3和~/.cache/sublime-text-3 - 删之前先看 Help → About Sublime Text,确认当前版本号,再进对应路径;别凭印象删 “Sublime Text” 就完事
Package Control.cache/ 目录本身——它藏得深,又不像 Cache/ 那么显眼。











