必须全局设置ignored files and folders添加node_modules并执行invalidate caches and restart，否则因历史索引残留、软链未递归排除及项目级配置污染，导致卡死、跳转错乱、类型解析失败；.gitignore完全无效。
必须全局设置 Ignored Files and Folders 加 node_modules，再执行 Invalidate Caches and Restart，否则几乎必然卡死、跳转错乱、索引不生效。
为什么“右键 Mark as Excluded”对 node_modules 基本不可靠
它只改项目级配置（写进 .idea/{project}.iml），但 WebStorm 在已索引状态下不会清理历史缓存，标完照样扫描、照样 CPU 暴涨。更麻烦的是：Excluded 会让 WebStorm 把 node_modules 当作“非源码目录”，导致 TypeScript 的 @types 解析失败、import 路径提示丢失、甚至 Cannot find module 'xxx' 报错——尤其在 pnpm/Yarn PnP 项目里极易触发。
常见误操作：
- 先装依赖再右键排除 → 旧索引残留，灰色不明显，Ctrl+Click 仍能跳进
node_modules - 用了
pnpm link或yarn link→node_modules是软链，WebStorm 默认不递归排除目标路径 - 协作中把
.iml提交了 → 其他人拉代码后自动继承错误排除，连带破坏类型系统
正确做法：全局忽略 + 强制清缓存
这是唯一对所有项目都稳定生效的方式，且不碰项目文件、不污染协作环境。
操作步骤：
- 打开
File > Settings > Editor > File Types > Ignored Files and Folders - 在输入框末尾添加：
node_modules（注意：不加斜杠、不加星号、不写node_modules/） - 点击
Apply，然后必须立刻执行File > Invalidate Caches and Restart > Invalidate and Restart
验证是否成功：
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 重启后
node_modules在 Project 面板中呈浅灰色、不可展开 - 右键菜单里没有
Open in Terminal、Reveal in Finder等选项 - 状态栏不再长时间显示
Scanning files，Loading indexes几秒内结束
Deployment 上传时还传 node_modules？那是另一套规则
Ignored Files and Folders 只影响本地索引，和上传行为完全无关。WebStorm 的 Deployment 功能有自己独立的排除逻辑。
要阻止上传 node_modules（或 dist、.env.local）：
- 打开
Tools > Deployment > Configuration - 切到
Options标签页 - 在
Exclude items by name输入框填：node_modules/, dist/, .env.local（逗号分隔，支持通配符）
⚠️ 注意：.gitignore 对 WebStorm 的索引和 Deployment 都完全无效——Git 忽略 ≠ IDE 忽略 ≠ 上传排除。
删 .idea 不是万能解，反而可能引发新问题
有人遇到标了 Excluded 还不生效，就直接删整个 .idea 目录再重开。这确实能清掉旧缓存，但代价是丢失所有本地配置：编码格式、断点设置、运行配置、甚至是已保存的 Live Templates。除非你确认项目没做任何个性化设置，否则不建议。
更稳妥的清理方式：
- 只删
.idea/misc.xml里疑似残留的node_modules条目 - 或用
File > Reload project from disk触发轻量级重载 - 若项目用了符号链接，先在终端运行
ls -la node_modules确认真实路径，再针对性加忽略（例如node_modules/my-pkg）
真正容易被忽略的点是：WebStorm 的“忽略”本质是两层隔离——索引层和上传层，缺一不可；而 node_modules 的特殊性在于，它既是构建产物，又是类型系统依赖源，所以不能简单“一刀切”排除，得用对地方、清干净缓存、再单独管住上传出口。
