必须右键node_modules→Mark Directory as→Excluded（非Ignored或Library Root），并验证其在Project Structure中完全灰掉；pnpm需同样处理.pnpm，yarn v3+需处理.yarn/cache。
WebStorm 里项目结构没理清楚，不是索引卡死、跳转失效，就是智能提示断断续续——根源往往不在代码，而在你没告诉 IDE 哪些文件该参与分析、哪些该彻底忽略。
如何正确标记 node_modules 为 Excluded
不这么做，WebStorm 会尝试解析数万个 JS/TS 文件，导致 CPU 占用飙升、Go to Definition 延迟明显，甚至触发“正在加载项目”假死状态。
- 在 Project 工具窗口 中右键点击
node_modules文件夹 - 选择 Mark Directory as → Excluded（不是
Ignored，也不是Library Root） - 若项目使用
pnpm，同样要对.pnpm文件夹执行相同操作；yarn v3+则需处理.yarn/cache - 验证：打开
File → Project Structure → Modules，确认node_modules下没有任何勾选项——它应完全灰掉
多个静态资源目录怎么统一管理
当图标、字体、模板片段等分散在不同物理路径（比如 ~/assets/icons 和 /srv/static/fonts），又想让它们在当前项目中可导航、可补全，就得靠多内容根。
- 打开
Settings → Directories（快捷键Ctrl+Alt+S） - 点击右侧的 Add Content Root，依次添加这些外部文件夹
- 添加后，它们会在 Project 窗口中显示为独立根节点，IDE 会对其内容做完整索引
- 注意：这些路径不会被写入
.idea目录外传，适合团队内共享配置但保留本地路径灵活性
tsconfig.json 路径别名没生效？检查 baseUrl 和 paths 是否被识别
WebStorm 默认只认 tsconfig.json 根目录下的配置。如果项目用了多级 tsconfig（如 src/tsconfig.json），IDE 可能根本没加载它，导致 @/components 这类别名跳转失败、类型提示丢失。
- 确认主
tsconfig.json在项目根目录，且"baseUrl": "./"存在 -
"paths"中的路径必须是相对于baseUrl的，例如："@/*": ["src/*"]，不能写成"@/*": ["./src/*"] - 改完保存后，手动触发
File → Synchronize或等待右下角索引完成提示 - 若仍无效，在
Settings → Languages & Frameworks → TypeScript中检查 “TypeScript version” 是否指向项目本地node_modules中的版本（而非 IDE 内置版本）
为什么 Structure 弹出窗口搜不到组件方法
Ctrl+F12 打开的结构视图默认只显示当前文件定义的内容。Vue SFC 或 React 组件中的 props、emits、computed 等声明，需要显式启用对应解析器才能纳入索引。
- 确保已安装并启用 Vue.js 插件（Settings → Plugins）
- 在
Settings → Languages & Frameworks → JavaScript → Libraries中，确认项目使用的 Vue 版本被正确识别（如vue@3.4.27） - 打开
Structure弹出窗口后，勾选 Inherited 和 Fields 复选框——否则defineProps解析出的属性不会显示 - 如果组件用了
defineComponent+ 选项式 API，还需在Settings → Languages & Frameworks → JavaScript → Vue.js中启用 “Use TypeScript for Vue files”
最常被忽略的是：内容根标记和 tsconfig.json 加载范围必须严格匹配。哪怕只差一层目录，IDE 就可能把你的源码当成普通文本处理——这时候再调 JVM 参数也没用。
