Sublime Text无法用编译系统清理缓存,因其受限于子进程环境且无法安全访问/删除被锁定的缓存文件;真正有效方案是退出程序后执行跨平台清理脚本并重启。

Sublime Text 没有、也不该用“编译系统”来清理缓存——构建系统(Build System)只负责调用编译器,它不管理 Cache 目录、语言服务器 socket 或索引文件。真要一键清缓存,得绕开 Build System,走手动路径+脚本封装这条路。
为什么 build system 不能用来清缓存
Build System 的本质是执行 shell 命令并捕获输出,但它运行在受限的子进程环境里:sublime-build 文件无法可靠访问 %LOCALAPPDATA%\Sublime Text\Cache\(Windows)、~/Library/Caches/com.sublimetext.4/(macOS)或 ~/.cache/sublime-text/(Linux),更没法安全删除被 Sublime 进程锁住的 socket 文件。你写个 "cmd": ["rm", "-rf", "$HOME/.cache/sublime-text"],大概率报错 Permission denied 或静默失败。
- Build System 启动时,Sublime 已经加载了 Cache 中的 LSP 索引;此时删目录,后续跳转、补全会直接卡死
- 即使命令成功执行,重启后 Sublime 仍会从
Saved Application State自动恢复插件状态——这不属于 Build System 能触达的范围 - 没有跨平台可靠的路径变量:Windows 用
$LOCALAPPDATA,macOS 用$HOME/Library/Caches,$project_path等内置变量在 Build System 中不展开为系统级路径
真正能一键清缓存的方案:外部脚本 + 快捷键绑定
核心思路是:退出 Sublime → 执行清理脚本 → 重新启动。所有操作必须在 Sublime 进程完全关闭后进行,否则删不干净。
- Windows:新建
clear_cache.bat,内容为:taskkill /f /im sublime_text.exe >nul 2>&1 rmdir /s /q "%LOCALAPPDATA%\Sublime Text\Cache" rmdir /s /q "%APPDATA%\Sublime Text\Packages\User\Package Control.cache" del /q "%LOCALAPPDATA%\Sublime Text\Saved Application State\*"
- macOS:新建
clear_cache.sh,加执行权限:#!/bin/bash killall "Sublime Text" 2>/dev/null rm -rf ~/Library/Caches/com.sublimetext.4/ rm -rf ~/Library/Saved\ Application\ State/com.sublimetext.4/ rm -f ~/Library/Application\ Support/Sublime\ Text/Packages/User/Package\ Control.cache
- Linux:同理用
killall sublime_text+rm -rf ~/.cache/sublime-text/+rm -rf ~/.config/sublime-text/Local/Saved\ Application\ State/
然后在 Sublime 里用 Tools → Developer → New Plugin… 写个简单命令,绑定快捷键(比如 Ctrl+Alt+Shift+C),调用 subprocess.run 执行对应脚本——注意路径要绝对,且确保脚本可执行。
删完缓存后必须关死进程再重启
这是最容易被跳过的致命步骤。只要 Sublime 的任意一个进程还在后台跑着(包括托盘图标、隐藏窗口、崩溃残留),Cache 目录就可能被重新锁定,删了也白删,甚至触发自动恢复逻辑。
- Windows:打开任务管理器 → 结束所有
sublime_text.exe进程(不止一个) - macOS:活动监视器里搜
Sublime Text,连带plugin_host和pyright类子进程一并杀掉 - Linux:
ps aux | grep sublime+kill -9所有 PID - 验证是否清干净:重启后打开命令面板
Ctrl+Shift+P,输入LSP: Restart Servers,如果报错server not found,说明清成功了
缓存不是越勤清越好——LSP 插件重建索引可能耗时数分钟。真正需要清的时候,只有两种:CPU 持续飙高、Goto Definition 失效且重启无效。其他时候,与其折腾一键脚本,不如定期手动删三处:Cache、Saved Application State、Packages/User 下对应插件的配置文件。


















