应将 node_modules 右键标记为 excluded，避免索引卡顿、补全变慢和内存溢出；需手动标记而非仅填入 exclude files，以确保嵌套 node_modules 也被忽略。
怎么把 node_modules 标记为 Excluded
不标记会导致索引卡死、补全变慢、甚至内存溢出。WebStorm 默认会索引整个项目目录，而 node_modules 里几万个文件根本不需要参与代码分析。
- 在 Project 工具窗口 中找到
node_modules文件夹，右键 → Mark Directory as → Excluded - 标记后该文件夹变成橙色图标，且不再出现在
Find Usages、Go to Declaration等操作中 - 如果已误删或重装过依赖，重新
npm install后 WebStorm 不会自动重新索引它——只要没取消 Excluded，就始终被忽略 - 注意：不要用
Exclude files字段填node_modules，那样只排除同名文件夹，但不会影响子路径里的嵌套node_modules（比如 monorepo 中的）；必须手动右键标记
多个内容根怎么加，又不互相干扰
常见于静态资源复用场景，比如把 assets/icons 单独拎出来给多个项目共用。加错会导致路径解析失败、资源预览失效、甚至 import 提示报错。
- 打开
Settings → Directories，点击右侧的Add Content Root - 选中一个**独立物理路径**（不能是已有内容根的子目录），比如
/Users/me/shared-assets - 添加后，该路径下所有文件都可被当前项目识别为“资源”，例如在
<img src="icon.svg">中输入时能自动补全 - 每个内容根是隔离的：一个根下的
tsconfig.json不会影响另一个；但若两个根都有package.json，WebStorm 可能混淆默认 Node.js 解释器 - 删除多余内容根要谨慎：
Remove操作只删配置，不删文件；但如果误删了主内容根，项目结构会直接崩（显示为空白目录树）
src 和 test 文件夹类别设错会怎样
设成普通源文件夹（灰色图标）和设成 Test Sources（绿色图标）看着差不多，但实际影响很大：测试文件里的 describe、it 不会被识别为可运行测试，覆盖率统计也归零。
-
src必须设为Sources（绿色图标不是必须的，但建议保持默认绿色），否则 TypeScript 类型检查会丢失模块路径别名（如@/utils） -
test或__tests__必须设为Test Sources，否则 WebStorm 不会激活 Jest / Vitest 运行按钮，也无法跳转到对应测试用例 - 如果项目用了
vitest.config.ts自定义测试目录，仅靠文件夹标记还不够，还得在Settings → Tools → Vitest里指定Test directory路径，否则仍不识别 - 误把
public设为Sources会导致 WebStorm 尝试解析 HTML 中的 JS 逻辑，引发大量假警告；应设为Resources（紫色图标）
为什么排除文件后 still shows up in Find in Path
很多人以为标记为 Excluded 就彻底隐身了，结果发现 Find in Path（Ctrl+Shift+F）还能搜到——这不是 bug，是设计行为。
-
Excluded只禁用 IDE 的语义功能（补全、导航、检查），但不影响文本级搜索，因为Find in Path是纯字符串匹配 - 真想全局屏蔽搜索，请去
Settings → Directories → Exclude files，填入*.log;dist/**这类 glob 模式（注意分号分隔） - 如果某文件被
Override File Type → Plain text排除，它仍会出现在搜索结果里，只是没有语法高亮和结构解析 - 最稳妥的“完全隐藏”方式：物理移出项目目录，或加到
.gitignore并勾选Settings → Version Control → Ignored Files → Show ignored files as plain text（此时连图标都变灰）
