invalidate caches / restart是唯一安全清理方式，它协调删除缓存、重置索引、清空本地历史并自动重建；手动删缓存目录易致启动失败、插件异常（如language service不可用）及本地历史残留无法同步。
直接删缓存目录会出事，别这么干
手动进~/Library/Caches/JetBrains/WebStorm2025.3（macOS）或%LOCALAPPDATA%\JetBrains\WebStorm2025.3（Windows）删文件，看着爽，但极可能触发三类问题：IDE 启动失败、Language service is not available报错、.idea/workspace.xml里保存的断点和窗口布局残留却无法同步刷新。WebStorm 的缓存不是静态垃圾，而是运行时状态快照，强制删除会破坏一致性。
Invalidate Caches / Restart 是唯一安全入口
所有“一键清理”需求，都必须走这个路径——它不是清缓存那么简单，而是协调重建整个 IDE 状态：
- 点击
WebStorm → Invalidate Caches / Restart…（macOS）或File → Invalidate Caches / Restart…（Windows/Linux） - 务必勾选这三项：
Clear file system cache and Local History、Clear VCS Log caches and indexes、Delete embedded browser engine cache and cookies - 点
Invalidate and Restart，不是Just Restart
没勾全等于白清；点错按钮等于没操作。
清理后右下角一直显示 Indexing…？正常，别中断
这不是卡死，是 WebStorm 在重建符号表和依赖图。尤其当项目含未排除的node_modules，索引可能持续 5 分钟以上。期间跳转、补全延迟是必然的。若卡在某个大文件（比如 20MB 的 JSON 日志），说明它不该被索引——立刻加进 Settings → Editor → File Types → Ignore files and folders。
如果反复卡顿，检查内存设置：Help → Change Memory Settings，把 -Xmx 调到 2048m～4096m（16GB 物理内存机器）。
插件卸载后残留怎么办？先清缓存再动手
中文包卸载后界面还是英文、某插件禁用后仍报 Plugin not loaded，大概率是缓存没清干净。不要一上来就删 ~/Library/Application Support/JetBrains/WebStorm2025.3/plugins/ 下的文件夹——先执行上一步的 Invalidate Caches / Restart 并勾全三项。
只有清完缓存重启后问题还在，才考虑手动删：
- macOS：删
~/Library/Application Support/JetBrains/WebStorm2025.3/plugins/下以zh、chinese或language-pack开头的文件夹 - 项目级残留要查
.idea/misc.xml和.idea/workspace.xml，删掉含language、locale、resourceBundle的配置节点
误删 options 或 extensions 目录里的全局配置，可能直接导致 IDE 启动失败。
