invalidate caches / restart 是官方唯一推荐的清理方式，它安全协调删除缓存、重置索引、清空本地历史并自动重建；手动删目录易致启动失败、插件异常或配置丢失。
直接删 WebStorm 缓存目录不是最安全的做法，Invalidate Caches / Restart 才是官方唯一推荐、能兼顾清理效果与 IDE 稳定性的操作路径。
为什么不能直接删缓存文件夹？
手动删除 ~/Library/Caches/JetBrains/WebStorm2025.3（macOS）或 %LOCALAPPDATA%\JetBrains\WebStorm2025.3（Windows）里的内容，看似彻底，但容易引发三类问题：
- IDE 启动失败：缓存目录里混有部分运行时锁文件或未完成写入的索引片段，强制删除可能破坏状态一致性
- 插件行为异常：某些插件（如 Vue 或 TypeScript 插件）会在缓存中固化语言服务会话数据，删完后不重启 IDE 就可能报
Language service is not available - 本地历史丢失且不可逆：如果没提前勾选
Clear file system cache and Local History，而只是手动清空缓存目录，.idea/workspace.xml里保存的断点、最近打开文件、折叠状态等仍残留，反而掩盖真实缓存污染问题
必须勾选的三个关键选项
执行 File → Invalidate Caches / Restart…（macOS 是 WebStorm → Invalidate Caches / Restart…）后，对话框里这三项不是“可选”，而是按场景必须启用：
-
Clear file system cache and Local History：解决窗口布局错乱、断点失效、搜索结果陈旧等问题；不勾选等于白清 -
Clear VCS Log caches and indexes：当你换过 Git 远程地址、git rebase重写历史、或看到Log is not available提示时，必须勾选 -
Delete embedded browser engine cache and cookies：前端调试时遇到登录态丢失、CSS 不刷新、WebSocket 连接复用异常，大概率是这个残留导致的
清理后“卡住”是正常现象，不是故障
点击 Invalidate and Restart 后，右下角持续显示 Indexing…、CPU 占用高、文件跳转变慢——这不是卡死，是 WebStorm 在重建符号表和依赖图。这个过程耗时取决于项目规模：
- 中小型项目（
- 含大量
node_modules的前端单体项目：可能持续 5～15 分钟，期间不要中断或强制退出 - 若超过 20 分钟仍无进展，检查
-Xmx设置是否过小（建议设为4096m），或临时禁用ESLint/Prettier等重型插件再试
真正要清理 C 盘空间时，别只盯 WebStorm 缓存
WebStorm 自身缓存一般占几百 MB 到 2GB，远不如这些目录“吃空间”：
-
node_modules：用find . -name "node_modules" -type d -prune -exec du -sh '{}' + | sort -hr | head -n 5快速定位最大几个 -
~/.m2/repository（Maven）、~/.gradle/caches（Gradle）：Java 开发者常忽略的“空间黑洞” -
C:\Windows\WinSxS和C:\Windows.old：系统级膨胀主力，用管理员权限运行cleanmgr并勾选“以前的 Windows 安装”和“Windows 更新清理”
WebStorm 缓存只是表象，真正压垮 C 盘的，往往是开发链路中多个环节的缓存叠加。动手前先用磁盘分析工具（如 WinDirStat / DaisyDisk）看一眼真实占用分布，比盲目删更有效。
