WebStorm卡顿若因内存不足，需勾选状态栏Memory Indicator观察内存使用，频繁红标或100%后GC即证实；此时CPU不高但延迟明显，应修改webstorm.vmoptions中-Xmx值（如4096m），并排除node_modules等目录、启用Shared Project Indexes插件、定期清理缓存。
怎么快速判断 WebStorm 是不是内存不足导致卡顿
右键点击 WebStorm 窗口右下角状态栏，勾选 Memory Indicator。如果内存条频繁变红、或经常显示“100%”后自动触发 GC（垃圾回收），基本就是堆内存不够用了。这时候再看 CPU 占用率不高、但操作明显延迟，就不用怀疑，直接调 -Xmx。
改 webstorm.vmoptions 调最大堆内存最直接
改这个文件比用 Toolbox 或菜单里的 Change Memory Settings 更可控，尤其在 macOS 或 Linux 上路径明确：
-
macOS：右键 WebStorm.app → 显示包内容 →Contents/bin/webstorm.vmoptions -
Windows：安装目录bin/webstorm64.vmoptions -
Linux：解压目录bin/webstorm.vmoptions
打开后重点改这行：-Xmx4096m（推荐值）。如果你机器有 16GB 内存，可以设到 6144m；但别超过物理内存的 40%，否则系统会开始 swap，反而更卡。改完保存，必须重启 WebStorm 才生效。
为什么 node_modules 必须排除，且不能只靠 .eslintignore
.eslintignore 只影响 ESLint 插件，WebStorm 自己的索引器完全不认它。真正起效的是 IDE 层面的排除：
- 在项目工具窗口中右键
node_modules文件夹 →Mark Directory as → Excluded - 同理排除
dist、build、.next、.nuxt这类构建产物目录 - 别用“Override File Type → Plain text”处理整个
node_modules—— 那只是骗语法高亮，索引照常进行，没用
排除后，索引时间下降 50% 以上是常态，内存峰值能稳降 1–2GB。
共享索引插件和缓存清理不是可选项，是必做项
JetBrains 官方明确把 Shared Project Indexes 插件列为性能优化核心组件，但它默认可能未启用：
- 进
Settings → Plugins，在已安装列表里搜Shared，确保勾选启用 - 每次大版本升级后，务必执行
File → Invalidate Caches and Restart → Invalidate and Restart - 不要选“Just Restart”，缓存不清掉，旧索引残留照样吃内存
注意：Invalidate Caches 后首次启动会重新索引，耐心等几分钟，之后的响应速度和内存稳定性会有明显区别。很多人跳过这步，结果调了半天内存还是反复卡——问题根本不在堆大小，而在索引脏数据。
