必须全局设置ignored files and folders添加node_modules并执行invalidate caches and restart，否则仅右键excluded无效；因旧索引残留、符号链接绕过及项目配置污染，excluded不清理历史缓存，搜索跳转仍生效，cpu持续飙升。
必须从索引层面排除，不是隐藏、不是忽略 Git、也不是靠右键“Excluded”就完事——否则搜索仍会命中、跳转依然生效、CPU 还是狂升。
为什么“Mark as Excluded”经常失效
标完 node_modules 仍是黑色、Ctrl+Click 还能跳进依赖里、全局搜索（Ctrl+Shift+F）照样扫出 node_modules/react/index.js ——这不是操作没点对，是 WebStorm 的“Excluded”只影响后续索引行为，不清理已有缓存。
- 旧索引残留：已扫描过的文件不会因标记 Excluded 就自动剔除，仍参与搜索和跳转
- 符号链接绕过：用
pnpm link或yarn link创建的软链，WebStorm 默认不递归识别其目标是否被 Excluded - 项目级配置污染：
.idea/{project}.iml中的<excludefolder></excludefolder>条目若写错路径或混入空格，会被静默忽略
真正生效的排除方式：全局 Ignored Files and Folders
这是唯一跨项目、免维护、重启即生效的方案。它直接让 WebStorm 在扫描阶段就跳过匹配路径，不建索引、不解析、不参与任何语义功能。
- 路径必须写为
node_modules（不带斜杠，不加通配符） - 多个条目用分号分隔，例如：
node_modules;dist;.next;build - 修改后必须执行
File → Invalidate Caches and Restart → Invalidate and Restart - 验证方式：重启后，在 Project 面板中
node_modules应呈灰色、不可展开；右键无Open in Terminal等选项
部署上传和本地索引是两套系统
在 Ignored Files and Folders 里加了 dist，只让 WebStorm 不索引它，但 Tools → Deployment 上传时照传不误。
- 要阻止上传，必须单独配置：
Tools → Deployment → Configuration → Options → Exclude items by name - 填入模式如：
dist/,.env.local,*.log（注意斜杠表示目录，逗号分隔） - 这个设置不影响本地索引，和
Ignored Files and Folders完全无关
单个文件无法右键 Excluded，只能靠名称匹配
WebStorm 不允许对单个文件执行 Mark as Excluded，这是硬限制。想排除 config.local.js 这类敏感文件，只能走全局规则：
- 在
Ignored Files and Folders输入框中添加：config.local.js - 或使用通配：
*.local.js（注意：通配符仅在该字段中有效） - 别指望
.gitignore里的条目会同步——WebStorm 完全不读它
最常被忽略的一点：排除动作本身不触发索引重建，必须手动 Invalidate Caches and Restart；而很多人点了“Excluded”就以为结束了，结果卡顿依旧、搜索照常，只是自己没意识到缓存还在起作用。
