webstorm跑不起来jest，90%是ide未识别jest环境所致：必须满足项目根目录存在jest.config.js/.ts或package.json含"test": "jest"脚本，且jest package路径需填本地node_modules/.bin/jest（pnpm项目用node_modules/jest/bin/jest.js），配置变更后必须重启ide才生效。
WebStorm 跑不起来 Jest，90% 不是 Jest 本身的问题，而是 IDE 没“认出”你的 Jest 环境——它不会自动扫描 node_modules，必须靠明确信号触发识别。
右键没 “Run Jest” 选项？先检查两个硬性凭证
WebStorm 只在满足以下任一条件时，才在测试文件右键菜单中显示 Jest 相关项：
- 项目根目录（即含
package.json的那层）存在jest.config.js或jest.config.ts -
package.json的scripts中定义了"test": "jest"（值可带参数，如"jest --runInBand"）
二者缺一，右键就只有“Run”“Debug”，没有“Run Jest”。常见踩坑点：配置文件放在 src/ 下、只装了 jest 但没写 test 脚本、用 pnpm 却把 jest.config.ts 放在 workspace 子包根目录而非 monorepo 根目录。
Cannot find module 'jest-cli' 报错？路径填错了
这个错误几乎全是 Jest package 字段指向错误引发的。WebStorm 默认可能找全局 jest，但你项目依赖的是本地版本。
- npm / yarn 项目：填
node_modules/.bin/jest（相对路径，不是绝对路径） - pnpm 项目：
node_modules/.bin/jest是坏链接，必须改用node_modules/jest/bin/jest.js - 绝对路径如
/usr/local/bin/jest或C:\Users\...\jest.cmd一律禁用 - 推荐勾选
Automatic模式，但改完必须重启 WebStorm 才生效
单个 it() 超时或跳过？不是 IDE 配置问题
报 Timeout - Async callback was not invoked 是 Jest 默认 5 秒超时与异步逻辑没对齐，WebStorm 只是透传原生错误。
- 检查是否混用
async it()和done()——二者只能选其一 - 若用了
async，函数体里必须return一个 Promise，或确保所有异步操作都await完 - 临时验证可加
jest.setTimeout(10000)到测试文件顶部 - WebStorm 的 “Run” 启动的是全新 Jest 进程，不继承终端里
jest --watch的 mock 状态或环境变量
点 “Run with Coverage” 没反应？覆盖率链路断在中间
覆盖率视图依赖 Jest 成功生成 coverage/lcov.info，任何一环断掉都会静默失败。
- 确认
jest.config.js没设collectCoverage: false，且coverageDirectory指向可写路径（默认coverage即可） - 如果配置了
coverageReporters: ['clover']或['json-summary']，WebStorm 解析不了，会显示空白 - 注意：WebStorm 不支持 ESM-only 项目直接生成覆盖率报告，若项目
"type": "module"且未配transform，collectCoverage可能被静默忽略
最易被忽略的点：所有配置变更（尤其是 Jest package 路径和 Automatic 开关）必须重启 WebStorm 才生效——它不热重载。
