webstorm 集成 jest 失败主因是配置未被识别：需确保存在 jest.config.js 或 package.json 的 test 脚本，jest path 指向本地 node_modules/.bin/jest（pnpm 项目用 node_modules/jest/bin/jest.js），启用 automatic 模式并重启 ide。

Jest 测试没反应？检查 jest.config.js 是否被 WebStorm 识别

WebStorm 不是自动“知道”你用 Jest 的——它得靠配置文件或 package.json 里的 test 脚本才能挂载运行器。如果右键点击 .test.js 文件没出现 “Run Jest” 选项，大概率是它根本没检测到 Jest 环境。

• 确认项目根目录下存在 jest.config.js、jest.config.ts 或 package.json 中有 "scripts": { "test": "jest ..." }
• 打开 File → Settings → Tools → Jest，检查 Jest package 路径是否指向项目本地的 node_modules/.bin/jest（不是全局安装的）
• 如果用了 TypeScript，确保 ts-jest 已安装且 jest.config.js 里 transform 配置正确，否则 WebStorm 可能加载测试文件失败但不报错

右键 Run 却报 Cannot find module 'jest-cli'

这是路径错配最典型的症状：WebStorm 找的是全局 Jest，但你项目依赖的是本地版本，而全局又没装或版本不兼容。

• 不要在 Settings → Tools → Jest 里填全局 jest 命令路径（比如 /usr/local/bin/jest）
• 改用 “Automatic” 模式，或手动指定为 node_modules/.bin/jest（注意是相对项目根目录的路径）
• 如果项目用 pnpm，node_modules/.bin/jest 可能是链接失效的，此时应选 node_modules/jest/bin/jest.js
• 重启 WebStorm —— 它不会热重载 Jest 配置变更

单个测试文件能跑，describe 块里某个 it 却跳过或报 Timeout - Async callback was not invoked

这不是 WebStorm 的问题，而是 Jest 默认超时（5s）和异步逻辑没对齐。WebStorm 只是把结果原样抛出来，容易误以为是 IDE 配置问题。

• 在对应 it 或 describe 上加 jest.setTimeout(10000) 临时验证是否超时导致
• 检查是否漏了 done() 回调，或 async/await 和 Promise 返回混用（比如写了 async it(...) 却没 return Promise）
• WebStorm 的 “Run” 是启动独立 Jest 进程，不会复用你终端里已起的 watch 模式，所以环境变量、mock 行为可能不一致

想看覆盖率，但 Run with Coverage 点完没反应或报错

覆盖率需要 Jest 自身支持 --coverage，且 WebStorm 必须能解析生成的 coverage/ 结果。很多失败其实卡在配置链路断了一环。

• 确保 jest.config.js 里没禁用 collectCoverage: true 或覆盖了 coverageDirectory 到不可写路径
• WebStorm 的覆盖率视图依赖 lcov.info，如果 Jest 配置输出的是 clover.xml 或 JSON 格式，Coverage 面板会空白
• 首次运行前删掉旧 coverage/ 目录，避免权限残留或缓存干扰
• 如果用了自定义 globalSetup，确认它没提前退出进程或修改了 process.exitCode

WebStorm 对 Jest 的集成其实很轻量，它只负责启动命令和解析 stdout/stderr。真正决定成败的，是 Jest 配置本身是否能在纯命令行下跑通——建议先在终端执行 npx jest --runInBand 确认基础流程，再回 IDE 调整。