必须在Settings → Editor → File Types → Ignored Files and Folders中追加带星号的后缀模式（如.log;.tmp;），用分号分隔，且需执行Invalidate Caches and Restart才能生效。
怎么在 File Types 里添加忽略的文件模式
WebStorm 默认会索引所有被识别为“代码文件”的内容，包括 .log、.tmp、.out、.map 等生成类文件——它们体积大、变动频繁，却几乎不参与开发逻辑，索引纯属浪费资源。正确做法是进 Settings → Editor → File Types，在 Ignored Files and Folders 输入框末尾追加模式，例如：*.log;*.tmp;*.out;*.map;（注意每个模式后加分号，已有内容别删）。
关键点在于：模式必须用 * 通配符，不能写成 logs/ 或 dist/*.map；路径匹配不生效，只认文件名后缀；大小写敏感（*.LOG 和 *.log 需分开写）。
为什么 .gitignore 里的规则对 WebStorm 完全无效
很多人把 dist/、.next/ 写进 .gitignore 就以为 IDE 会自动跳过——这是常见误解。.gitignore 只控制 Git 行为，WebStorm 的索引系统完全不读它。你仍会看到状态栏持续显示 Scanning files in dist/，CPU 占用飙升，甚至 Find in Path 慢得像在扫硬盘。
真正起作用的只有两处：Ignored Files and Folders（全局生效）或 Directories → Excluded（项目级，慎用）。前者安全稳定，后者可能破坏 pnpm/Yarn PnP 的符号解析。
排除 .map 文件后 TypeScript 跳转还失效？检查 Source Maps 设置
排除 *.map 后，如果 Ctrl+Click 进不到源码，不是忽略错了，而是 WebStorm 仍在尝试通过 sourcemap 反向定位——这反而会触发额外解析。需同步关闭相关功能：
- 进
Settings → Languages & Frameworks → JavaScript → Debugging，取消勾选Enable source maps - 在
Settings → Editor → Inspections → JavaScript中，关掉Invalid source map类检查 - 确认没有在
webpack.config.js或vite.config.ts里启用devtool: 'eval-source-map'这类高开销模式
否则即使文件被忽略，IDE 仍会在后台尝试加载和解析 map 内容，造成隐性卡顿。
临时生成的 JSON 或 HTML 文件要不要排除
像 coverage/lcov-report/*.html、mock-data/*.json 这类文件，是否排除取决于用途：
- 如果是测试产出（如
coverage/），必须加到Ignored Files and Folders：它们结构深、文件多，且每次测试都重写，极易引发反复索引 - 如果是人工维护的 mock 数据（如
mock-data/user.json），建议不忽略，保留编辑时的 JSON Schema 校验和补全 - 若部分
.json是机器生成、部分是手写，不要用*.json一刀切，改用更精确路径，例如：coverage/**;dist/**;build/**;
最易被忽略的是：排除规则生效后，WebStorm 不会自动清理已建索引，必须执行 File → Invalidate Caches and Restart → Invalidate and Restart 才能彻底释放内存和 CPU。
