必须忽略 node_modules，否则WebStorm会因扫描数万文件导致卡死、CPU飙升、补全变慢；唯一可靠方法是全局设置Ignored Files and Folders添加node_modules;并重启。
WebStorm 为什么必须忽略 node_modules
不忽略 node_modules，WebStorm 会在启动和编辑时疯狂扫描数万文件，导致“Loading indexes”卡死、CPU 暴涨、自动补全变慢、甚至编辑器假死。这不是配置问题，是设计使然——node_modules 本质是构建产物，不是源码，索引它毫无意义，只拖累开发体验。
- 典型现象：
Loading indexes...持续 2 分钟以上；右下角状态栏长时间显示 “Scanning files”；打开新文件时延迟明显 - 影响范围：所有依赖 WebStorm 语义分析的功能，包括跳转定义（
Ctrl+Click）、重命名（Shift+F6）、Find Usages、TypeScript 类型提示 - 注意：仅靠
.gitignore或删除node_modules后重装，完全无效——WebStorm 索引行为与 Git 无关
最可靠的方法：全局设置 Ignored Files and Folders
这是唯一推荐的方案，生效快、不依赖项目结构、重启后立即见效。适用于所有 WebStorm 版本（2022.3 及以后），且对已存在的项目也零侵入。
- 路径：
File → Settings → Editor → File Types → Ignored Files and Folders - 在输入框末尾添加：
node_modules;（注意分号结尾，已有内容勿删） - 点击
Apply，然后必须执行：File → Invalidate Caches and Restart → Invalidate and Restart - 验证是否生效：重启后，在 Project 面板中
node_modules应呈灰色、不可展开；右键菜单里没有 “Open in Terminal” 或 “Reveal in Finder” 等选项
别碰 Mark as Excluded —— 容易踩坑的旧方法
用 Project Structure → Mark as Excluded 排除 node_modules 看似直观，但实际问题一堆，尤其对已有项目几乎必翻车。
- 风险点1：WebStorm 会把整个
node_modules当作“非模块内容”，可能导致import路径解析失败、TypeScriptnode_modules/@types类型丢失 - 风险点2：如果项目用了 pnpm 或 Yarn PnP，
Excluded会破坏链接结构，引发模块解析错误（如Cannot find module 'xxx'） - 风险点3：该设置写在
.idea/{project}.iml里，属于项目级配置，容易误提交或在协作中引发不一致 - 替代做法：真要临时排除某个子目录（比如自己写的本地包），用
Ignored Files and Folders加具体路径更安全，例如：node_modules/my-local-pkg;
.gitignore 里的 node_modules/ 和 WebStorm 无关
很多人以为只要 .gitignore 写了 node_modules/，WebStorm 就会自动忽略——完全错误。Git 和 IDE 的索引系统彻底隔离。
-
.gitignore只控制 Git 是否跟踪文件，不影响 WebStorm 是否扫描、索引、高亮或补全 - 你可以在
.gitignore里漏写node_modules，只要 WebStorm 的Ignored Files and Folders设置正确，照样不卡 - 反过来说：就算
.gitignore写对了，WebStorm 没配忽略，照样卡成PPT - 额外提醒：如果
node_modules已被 Git 跟踪过，得先运行git rm -r --cached node_modules，否则.gitignore不生效——但这和 WebStorm 性能无关
node_modules 的处理逻辑很直接：它只认自己配置里的忽略规则。其他任何地方的声明，包括 package.json、tsconfig.json、甚至操作系统级隐藏属性，它一概无视。设错一次可能浪费半小时等索引，设对一次能省下几个月等待时间。 
