webstorm全局搜索跳过node_modules和@types的唯一可靠方法是：在ctrl+shift+f搜索对话框中点击file mask旁的…→add→directory，分别添加node_modules和node_modules/@types并设为excluded；该设置仅作用于搜索范围，不影响ts解析或索引，且不污染项目配置。
搜索时跳过 node_modules 和 @types 目录
WebStorm 默认会在全局搜索（Ctrl+Shift+F）中包含 node_modules 和 @types 下的所有文件，导致结果冗长、响应变慢，甚至卡死。这不是“能不能搜到”的问题，而是“该不该默认搜”的问题——第三方库源码不是你改的，也不该出现在日常搜索上下文中。
真正有效的做法是：在搜索对话框里手动排除路径，而不是依赖项目配置或缓存清理。
- 打开全局搜索（
Ctrl+Shift+F），勾选 File mask 右侧的 … 按钮 - 在弹出窗口中点击 + Add → 选择 Directory
- 分别添加两个排除路径：
node_modules和node_modules/@types（注意：不加斜杠，不写**，就写这两个纯目录名） - 确保它们的状态是 Excluded（不是 Included），然后点 OK
此后每次搜索都会自动跳过这两个目录，且该设置会保存为当前项目的默认搜索范围。如果换项目，需重新配置一次。
为什么不用 Mark as Excluded 或 Ignored Files and Folders？
这两个入口常被误用为“搜索过滤方案”，但它们实际作用完全不同：
-
Mark as Excluded是让 WebStorm 把目录当“非源码”处理，会直接破坏 TypeScript 的@types解析，引发Cannot find module 'xxx'报错，尤其在 pnpm/Yarn PnP 项目里必现 -
Ignored Files and Folders（在Settings > Editor > File Types）只影响索引和语法高亮，对全局搜索 完全无效 —— 它控制的是“哪些文件被 IDE 理解”，不是“哪些文件被搜”
也就是说：想让搜索不出现第三方库，唯一可靠路径就是搜索对话框里的 Directory exclusion，别绕弯。
搜索还扫到了 .d.ts 文件或本地 mock 包？
有些团队会把类型声明放在 src/types，或用 pnpm link 把本地包软链进 node_modules。这类路径不会被默认排除，容易混进搜索结果。
- 若要排除特定本地包（如
my-utils），在搜索对话框的 Directory 排除列表中直接加：node_modules/my-utils - 若要排除所有
.d.ts文件（比如你只关心实现，不查类型定义），在 File mask 栏填：!*.d.ts（注意开头的!表示排除） - 软链目标路径不会被自动跟随排除，必须显式写出真实路径（可用
ls -la node_modules/my-utils查看实际指向）
搜索范围设错了，怎么快速重置？
一旦加了错误的排除路径，比如误写了 src/node_modules 导致自己写的模块也被跳过，很难直观发现。最省事的恢复方式是：
- 打开任意一次搜索对话框（
Ctrl+Shift+F） - 点击右下角 Configure search scope…
- 在弹出窗口中，找到已添加的目录条目，选中后点 - Remove
- 清空后点 OK，下次搜索就回归默认全项目范围
这个配置不写进 .idea，也不同步到协作环境，纯本地 UI 状态。所以不必担心污染他人项目，但也要记得：每次重装或迁移 WebStorm 后得重配一遍。
