WebStorm右键无“Run Jest”选项，是因为未满足Jest识别的两个硬性条件：项目根目录存在jest.config.js/.ts，或package.json中scripts含"test": "jest"；Jest package路径须填node_modules/.bin/jest（npm/yarn）或node_modules/jest/bin/jest.js（pnpm），填错将报Cannot find module 'jest-cli'，且配置变更后必须重启IDE才生效。
右键没“Run Jest”选项？先确认 Jest 被 WebStorm “认出来”了
WebStorm 不会自动扫描 node_modules 里有没有 jest，它只靠两个硬性信号判断是否启用 Jest 运行器：
- 项目根目录（即含
package.json的那层）存在jest.config.js或jest.config.ts -
package.json的scripts中定义了"test": "jest"（值可以带参数，比如"jest --runInBand"）
两者缺一，右键测试文件就看不到 “Run Jest” 或 “Debug Jest”。装了 jest 但没写 test 脚本、或配置文件放错目录（比如放在 src/ 下），都会导致识别失败。
Jest package 路径填错 → 报 Cannot find module 'jest-cli'
这个报错几乎全是路径指向错误引发的。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 模式（Settings → Tools → Jest → Jest package → Automatic），但改完必须重启 WebStorm 才生效
单个 it() 超时或跳过？别怪 WebStorm，是 Jest 自身行为
报 Timeout - Async callback was not invoked 不是 IDE 配置问题，而是 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 解析不了，会显示空白 - 确保
lcov.info真的被写入 —— 可手动在终端运行npx jest --coverage看是否生成该文件 - Working directory 必须设为项目根目录，否则
moduleNameMapper或setupFilesAfterEnv中的相对路径全部失效，导致模块加载失败
最易被忽略的是：配置改完不重启 WebStorm，所有变更都不生效；pnpm 用户死磕 node_modules/.bin/jest 就会一直卡在 Cannot find module。
