webstorm 卡死主因是 node_modules 被索引，解决方法：右键标记为 excluded；检查并移除 libraries 中的 node_modules；调大 vm 内存（-xmx4096m -xx:reservedcodecachesize=1024m）；关闭“index all files”；pnpm/yarn pnp 项目需额外检查嵌套目录。
npm install 时 WebStorm 突然卡死，90% 是 node_modules 被索引了
WebStorm 默认会递归扫描整个项目目录，而 node_modules 平均含 3–8 万文件。安装过程一触发，IDE 就开始解析 AST、建符号表、更新跳转关系——你根本不会编辑这些文件，但它照做不误，CPU 占满、UI 冻结、甚至假死。
这不是 npm 慢，也不是网络问题，是 WebStorm 在“主动加班”。解决核心就一条：让 node_modules 彻底退出索引流程。
- 右键点击项目中的
node_modules文件夹 → Mark Directory as → Excluded（图标变成灰色才生效） - 如果已安装完依赖再操作，先 删掉
node_modules，新建一个空文件夹，再标记为Excluded，避免残留索引状态 - 检查
Settings → Languages & Frameworks → JavaScript → Libraries，确认没把node_modules手动加为Library root（有这字样必须点Remove） - 同样处理其他产出目录：
dist、build、.next、unpackage、coverage
为什么 exclude 后还要调 webstorm.vmoptions
即使排除了 node_modules，JVM 堆内存太小仍会导致索引中途降级：TS 类型检查变弱、补全延迟、跳转失败——现象是“有时快有时慢”，实际是 GC 频繁 + 缓存溢出。
ReservedCodeCacheSize 尤其关键，TypeScript 语言服务靠它缓存编译字节码，缺了就会退化成“猜词式”补全。
- 打开
Help → Edit Custom VM Options（首次会提示创建） - 按物理内存设堆大小：
-Xms2048m -Xmx4096m（16GB 机器），-Xmx别超物理内存 1/3 - 务必加上：
-XX:ReservedCodeCacheSize=1024m - 改完必须完全退出 WebStorm（不是关窗口）再重启，否则参数不加载
npm install 过程中 WebStorm 还在后台扫文件？关掉“Index all files”
默认勾选的 Index all files in the project 是索引慢的隐藏推手。它会让 IDE 在安装依赖时同步扫描所有未 exclude 的文件，哪怕你只开了一个 index.ts。
真正需要的是“按需索引”：只分析你正在看、正在编辑的文件。
- 进
Settings → Indexing - 取消勾选：
Index all files in the project - 勾选：
Enable indexing of files opened in editor only - 在
Excluded paths输入框里补全路径，用分号隔开：node_modules;dist;build;.git;.idea
pnpm / Yarn PnP 项目容易漏掉的坑
pnpm 的硬链接结构和 Yarn PnP 的 .zip 依赖机制，会让 WebStorm 误判路径关系。即使你标记了 node_modules 为 Excluded，它仍可能从 Settings → Libraries 里拉取符号，导致索引反复触发。
这类项目必须多做一步验证，否则 exclude 白设。
- 打开
Settings → Languages & Frameworks → JavaScript → Libraries - 检查列表里是否出现
node_modules或类似pnpm:*的条目 - 只要不是你手动添加的第三方库，一律
Remove - 重启后观察状态栏右下角的索引进度条：如果安装依赖时不再跳动，说明生效
最常被忽略的是“exclude 图标只出现在顶层目录”，但 pnpm 实际会在 node_modules/.pnpm 下生成嵌套结构——WebStorm 不会自动递归 exclude 子目录，得手动点进去再 exclude 一次。
