webstorm 应通过 settings → editor → file types → ignored files and folders 添加 node_modules;（分号结尾）并重启，而非右键 mark as excluded；后者破坏 pnpm/yarn pnp、导致 ts 类型丢失且易误提交；还需同步忽略 dist、build 等目录，清理 js libraries 中冗余 node_modules 引用，并禁用 kotlin 等无关插件。

WebStorm 默认会索引 node_modules，这是它变慢的最常见原因——不是配置错了，而是根本没关对地方。直接右键 node_modules → Mark Directory as → Excluded 看似快，但容易导致 TypeScript 类型丢失、import 路径解析失败，尤其在 pnpm/Yarn PnP 项目里会报 Cannot find module 'xxx'。

用 Ignored Files and Folders 全局生效且安全

这才是 JetBrains 官方推荐、兼容所有包管理器（包括 pnpm 和 Yarn PnP）的正确方式：

• 打开 File → Settings → Editor → File Types → Ignored Files and Folders
• 在输入框末尾追加：node_modules;（注意分号结尾，已有内容别删）
• 点击 Apply，然后必须执行 File → Invalidate Caches and Restart → Invalidate and Restart
• 重启后验证：node_modules 在项目面板中仍是彩色可展开状态，但顶部状态栏不再显示 “Indexing node_modules…”；搜索和跳转响应明显变快

为什么不能只靠 Mark as Excluded

这个操作写入的是 .idea/{project}.iml，属于项目级配置，有三个硬伤：

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• Excluded 会让 WebStorm 彻底忽略该目录结构，破坏 pnpm 的硬链接或 Yarn PnP 的虚拟文件系统，TS 编译器找不到 @types 包
• 协作时容易误提交 .iml 文件，导致队友开项目就报错
• 如果项目用了 Vite 或 Next.js，Excluded 还可能干扰 resolve.alias 或 optimizeDeps.include 的路径识别

配套必须做的三件事

单设 Ignored Files and Folders 不够，还要同步处理这些“索引寄生源”：

• 在同一个 Ignored Files and Folders 输入框里补全：dist;build;.next;.nuxt;coverage;.cache;.git;.idea;
• 检查 Settings → Languages & Frameworks → JavaScript → Libraries，确认 node_modules 没被手动添加进库路径（尤其旧项目迁移后常残留）
• 禁用无关插件：进 Settings → Plugins，按启用状态排序，关掉 Kotlin、Database Tools and SQL、Subversion Integration 等前端项目完全用不到的插件——它们会在索引阶段主动扫描全部文件

真正卡顿的根源，往往不是 node_modules 本身，而是它触发了其他插件的全量扫描 + JVM 内存不足下的服务降级。做完上述设置后，如果仍出现补全延迟或跳转失败，大概率是 -Xmx 没调够，或者 -XX:ReservedCodeCacheSize 缺失——这两项不改，前面所有操作效果会打七折。