应通过 Settings → Editor → File Types → Ignored Files and Folders 添加 node_modules;dist;build;.next;.nuxt;coverage;.cache;.git;.idea;（分号结尾），并执行 Invalidate Caches and Restart；同时清理 JS Libraries 中冗余引用、禁用无关插件、调整 VM 参数。
Vue 项目在 WebStorm 里打开就卡、搜索慢、跳转延迟，90% 是 node_modules 被索引了。它不是“加载慢”，而是 IDE 在反复解析几万个你永远不会改的文件——直接关掉这个行为，就能立竿见影。
为什么不能只右键 Mark as Excluded
这个操作看似简单，但在 Vue（尤其是 Vue 3 + Vite）项目里容易引发类型丢失、Cannot find module 'vue'、路径解析失败等问题。原因在于：Mark as Excluded 会让 WebStorm 完全忽略该目录结构，破坏 pnpm/Yarn PnP 的链接机制，也干扰 Vite 的 resolve.alias 和 TypeScript 的 @types 查找路径。
-
Excluded写入的是.idea/{project}.iml，属于项目级配置，协作时容易误提交，队友一开项目就报错 - Vue 单文件组件（
.vue）依赖node_modules中的类型定义，排除后 TS 语言服务会退化为“猜词式”补全 - 部分插件（如 Vue.js 插件）会在索引阶段主动扫描
node_modules，Excluded并不能阻止它们触发全量扫描
正确做法：用 Ignored Files and Folders 全局屏蔽
这是 JetBrains 官方推荐、兼容 Vue/Vite/TS/pnpm/Yarn PnP 的安全方式。它不破坏目录结构，只让索引器跳过这些路径：
- 打开
File → Settings → Editor → File Types → Ignored Files and Folders - 在输入框末尾追加：
node_modules;dist;build;.next;.nuxt;coverage;.cache;.git;.idea;（注意每个项后加分号，已有内容别删） - 点击
Apply，然后必须执行File → Invalidate Caches and Restart → Invalidate and Restart - 重启后验证：状态栏不再显示
Indexing node_modules...，且node_modules在项目视图中仍为彩色可展开状态
配套必须清理的三个“索引寄生源”
光设 Ignored Files and Folders 不够，以下三处残留会继续拖慢索引：
使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景：(1) 安装 `@ainative/vue-sdk`，(2) 在 Vue 组件中使用 `useChat` 组合式函数，(3) 提供……
立即学习“前端免费学习笔记（深入）”；
- 检查
Settings → Languages & Frameworks → JavaScript → Libraries，确认没有手动把node_modules加为 Library root（有就点Remove） - 进
Settings → Plugins，按启用状态排序，禁用Kotlin、Database Tools and SQL、Subversion Integration等前端项目完全用不到的插件 - 打开
Settings → Indexing，取消勾选Index all files in the project，勾选Enable indexing of files opened in editor only
VM 参数不调，索引仍会悄悄降级
即使排除了 node_modules，JVM 堆内存太小也会导致索引中途 GC 频繁、TS 类型检查变弱、补全延迟——现象是“有时快有时慢”，实际是服务在降级运行。
- 打开
Help → Edit Custom VM Options，写入（16GB 物理内存示例）：-Xms2048m -Xmx4096m -XX:ReservedCodeCacheSize=1024m -
-Xmx别超物理内存 1/3；ReservedCodeCacheSize必须设，否则 TypeScript 编译字节码缓存溢出，补全退化 - 改完必须彻底退出 WebStorm（不是关窗口），再重启，否则参数不生效
真正卡顿的根源，从来不是 node_modules 有多大，而是它触发了插件全量扫描 + JVM 内存不足下的服务降级。做完这四步，Vue 项目启动和日常操作的响应速度基本回归正常——但要注意，Invalidate and Restart 后首次打开仍需重建索引，耐心等 1–2 分钟，之后就稳定了。
