invalidate caches / restart 是最安全有效的清理方式，它协调删除缓存、重置索引、清空本地历史并自动重建；手动删目录易致启动失败或配置丢失，仅当 ide 无法启动或插件异常时才考虑。
直接点：用 Invalidate Caches / Restart 是最安全、最有效的清除方式
WebStorm 的缓存和索引不是“垃圾文件”，而是它理解你项目的关键数据——比如符号跳转、类型推导、代码补全都靠它。手动删目录看似彻底，但极易导致 IDE 启动失败、插件异常或项目配置丢失。官方唯一推荐的清理入口就是 Invalidate Caches / Restart，它会协调删除缓存、重置索引状态、清空本地历史，并在重启后自动重建——所有操作都在 IDE 控制下完成，不破坏结构。
怎么操作：三步走，别跳过勾选项
打开菜单 File → Invalidate Caches / Restart…（macOS 是 WebStorm → Invalidate Caches / Restart…），弹出对话框后注意以下几点：
- 勾选
Clear file system cache and Local History：否则.idea/workspace.xml里保存的窗口布局、断点、最近文件等不会重置，可能掩盖真实问题 - 勾选
Clear VCS Log caches and indexes：尤其当你换过 Git 仓库地址、重写过历史，或看到 “Log is not available” 类错误时必须选 - 勾选
Delete embedded browser engine cache and cookies：如果你常在 WebStorm 内置浏览器调试前端页面，这里残留的 Cookie 或缓存可能导致登录态异常或样式错乱 - 点击
Invalidate and Restart，而不是Just Restart——后者完全不清理任何东西
清理后为什么更卡？索引重建是正常过程，不是故障
点击 Invalidate and Restart 后，WebStorm 会花几十秒到十几分钟（取决于项目大小）重新扫描整个项目、解析依赖、构建符号表。这时你会看到右下角持续显示 “Indexing…”、“Loading project structure…” 或 CPU 占用飙升。这不是卡死，是必要工作流：
- 大型项目（如含
node_modules未排除）可能索引超 5 分钟，期间补全和跳转会延迟响应 - 如果索引长时间卡在某个文件（比如一个 20MB 的 JSON 日志），说明该文件不该被索引——应把它加进
Settings → Editor → File Types → Ignore files and folders - 若重启后仍反复卡顿，大概率是内存不足：检查
Help → Change Memory Settings，把-Xmx调到 2048m～4096m（16GB 内存机器）
什么时候才需要手动删缓存目录？仅限 IDE 启动失败或插件卸载后行为异常
只有当 Invalidate Caches / Restart 点了没反应、IDE 根本打不开、或者卸载插件后仍有报错提示“Plugin X is missing class Y”时，才考虑手动清理。此时目标很明确：只删缓存，不动配置。
- macOS 缓存路径：
~/Library/Caches/JetBrains/WebStorm2025.3（版本号替换成你实际的） - Windows 缓存路径：
%LOCALAPPDATA%\JetBrains\WebStorm2025.3 - Linux 缓存路径：
~/.cache/JetBrains/WebStorm2025.3 - ⚠️ 绝对不要删
Application Support（macOS）或AppData/Roaming（Windows）里的配置目录——那是你的主题、快捷键、插件设置所在，删了等于重装
删完缓存目录后，仍需手动启动 WebStorm 并让它重建索引；如果之前改过 webstorm.vmoptions，也要确认文件没被覆盖回默认值。
