必须全局设置Ignored Files and Folders添加node_modules并执行Invalidate Caches and Restart，否则因缓存残留、软链未递归排除及项目级配置污染，导致卡死、跳转错乱、类型解析失败；.gitignore完全无效。
怎么让 node_modules 彻底“消失”在 WebStorm 里
只加 .gitignore 或右键 Mark as Excluded 都不行——前者对 IDE 完全无效，后者常因缓存残留、软链接或项目级配置污染而失效。真正生效的路径只有一条：全局忽略 + 强制清缓存。
- 打开
File > Settings > Editor > File Types > Ignored Files and Folders - 在输入框末尾添加：
node_modules（注意：不带斜杠、不加星号、不写路径） - 点击
Apply，然后必须执行File > Invalidate Caches and Restart > Invalidate and Restart - 验证：重启后
node_modules不再显示在 Project 树中，右键无Open in Terminal，Ctrl+Shift+N搜不到其内部文件
若用了 pnpm link 或 yarn link，别强行标 Excluded——WebStorm 不递归处理软链目标，反而可能破坏 @types 解析和 import 跳转。
为什么 .env.local 或 dist 文件夹还在 Project 视图里
Ignored Files and Folders 字段只匹配完整文件夹名，不支持通配符嵌套或模糊匹配。写 dist 只能屏蔽根目录下的 dist/，对 src/dist 或 build/dist 无效；写 .env.* 也完全不生效。
- 要覆盖多级路径，得逐个列全：
dist;build;out;.next;.nuxt;public/dist -
.env.local必须完整写出，不能拆成.env和local，中间不能有空格 - 改完设置后，Project 工具窗口不会自动刷新——右键标签页选
Reload project，或关闭再重新打开该窗口
被 Ignored 的路径连加载都不加载，性能比 Excluded 更好，但代价是：你无法通过 Project 树导航访问它们，只能靠 Ctrl+Shift+A → Open file 手动输入路径。
Deployment 上传时还传了 node_modules？那是另一套规则
Ignored Files and Folders 只控制本地索引，跟上传行为毫无关系。WebStorm 的 Deployment 是独立系统，即使 node_modules 已全局忽略，它仍会照常上传，除非你手动配排除规则。
- 打开
Tools > Deployment > Configuration - 切到
Options标签页 - 在
Exclude items by name输入框填：node_modules/;dist/;.env.local;*.log（支持通配符，用分号或逗号分隔）
注意：这里必须加斜杠（node_modules/），否则可能只排除同名文件而非整个目录；且这个配置只影响上传/下载，不影响 Git 提交或本地索引。
能不能只忽略单个文件，比如 .env.development
不能右键单个文件点 Excluded——这是 WebStorm 的硬限制，官方文档明确说明“仅支持目录级排除”。唯一可行方式是按名称匹配忽略。
- 进
Settings > Editor > File Types > Ignored Files and Folders - 添加完整文件名：
.env.development（不是.env.*，也不是.env.development.*） - 同样需要
Invalidate Caches and Restart才生效
如果项目里有大量类似文件（如 .env.test、.env.staging），一个个列太麻烦，建议统一用 .env.* ——但这招在 Ignored Files and Folders 里无效，只能退而求其次：把整个 .env.* 目录结构挪到单独文件夹下，再忽略该文件夹。
