WebStorm项目分析默认始终运行，感知不到常因索引卡顿或检查被禁用；需启用实时检查、排除非源码目录、正确配置V8 Profiling并排查日志权限等问题。
WebStorm 的项目分析不是开关式功能，它默认始终运行——但你感知不到，往往是因为索引卡在某个环节，或关键检查被意外关闭。真正要“启用”的，其实是让分析结果可见、可干预、可加速。
为什么改了代码没提示错误？检查是否禁用了实时分析
WebStorm 默认在编辑时实时扫描语法、类型、未定义变量等问题，但这个行为可能被关掉：
- 右键点击编辑器右下角状态栏 → 取消勾选
Inspection（如果它显示为灰色或带斜杠） - 打开
Settings | Editor | Inspections→ 确保顶部的Enable inspections while typing已勾选 - 若只对当前文件失效，检查右上角灯泡图标旁的下拉菜单，确认高亮级别不是
Syntax或None - ESLint/TS 一类外部检查需单独配置：确保
Settings | Languages & Frameworks | JavaScript | Code Quality Tools中对应工具已启用且路径正确
大型项目索引慢？优先排除非源码目录
WebStorm 对 node_modules、dist、.next、build 这类目录默认仍会扫描（尤其当它们含 package.json 或 TypeScript 声明时），拖慢整体分析速度：
- 在
Project工具窗口（Alt+0+1）中右键目标文件夹 →Mark Directory as | Excluded - 不要用
Remove from Project，那会删引用；Excluded才是语义上“不参与索引” - 确认排除生效：被排除的文件夹图标带
⊘，且不再出现在Find Usages或Go to Symbol结果中 - 若用 pnpm，注意
node_modules/.pnpm下软链可能绕过排除——建议直接排除整个node_modules
V8 Profiling 不出数据？关键在运行配置绑定
Profiler 不是独立面板，它依赖运行时采集。Node.js 项目必须走 Node.js 类型配置，且明确开启 V8 分析：
- 打开
Run | Edit Configurations…→ 选中你的 Node.js 配置 → 切到V8 Profiling标签页 - 必须勾选
Record CPU profiling info；Log folder设为项目内路径（如./.profiling），避免写入失败 - 不能用
npm start配置：它属于npm类型，没有V8 Profiling标签页；改用Node.js类型并填入node ./src/index.js路径 - 启动后不会弹窗，日志生成在指定目录，文件名类似
isolate-00001234.cpuprofile；需手动右键 →Analyze JavaScript Profiling Result
真正卡住项目的，往往不是“没启用分析”，而是分析范围过大、外部工具链干扰（比如 ts-node 加载器屏蔽 V8 参数）、或日志路径权限异常。先看状态栏有没有 Indexing… 提示，再查 Help | Diagnostic Tools | Debug Log Settings 开启 com.intellij.openapi.project.impl.ProjectIndexing 日志，比盲目调参数更直接。
