WebStorm无法运行Jest测试，主因是未显式配置Jest环境：需存在jest.config.js/.ts或package.json中scripts含"test": "jest"；Jest路径应设为Automatic或正确相对路径；异步测试超时需调整jest.setTimeout()；覆盖率失效多因配置错误或coverage-final.json缺失。
WebStorm 跑不起来 Jest 测试，90% 是因为没让 IDE “认出” Jest 环境——它不会自动扫描 node_modules 里的 jest，必须靠显式配置或约定文件触发识别。
为什么右键没出现 “Run Jest” 选项
这是最常见、也最容易被误判为“IDE 坏了”的问题。WebStorm 不是靠安装了 jest 就自动启用 Jest 运行器的，它依赖两个明确信号之一：
- 项目根目录存在
jest.config.js或jest.config.ts -
package.json的scripts中定义了"test": "jest"（或类似含jest的命令）
如果两者都缺，右键菜单里就不会有 Jest 相关项。注意：仅在 devDependencies 里装了 jest 不够，WebStorm 不会主动遍历依赖去匹配。
Jest package 路径填错导致 Cannot find module 'jest-cli'
这个报错几乎全是路径配置错误引发的。WebStorm 默认可能指向全局 jest，但你项目用的是本地 node_modules/.bin/jest（尤其是 pnpm 用户，.bin/jest 往往是坏链接）。
- 推荐选 Automatic 模式（Settings → Tools → Jest → Jest package → Automatic），让 WebStorm 自己找
- 手动填时，务必用相对路径：
node_modules/.bin/jest（npm/yarn）或node_modules/jest/bin/jest.js（pnpm） - 绝对路径如
/usr/local/bin/jest或C:\Users\...\jest极易失败，尤其跨 Node 版本或项目隔离时
改完必须重启 WebStorm——配置变更不会热生效。
单个 it() 跳过或报 Timeout - Async callback was not invoked
这不是 WebStorm 的锅，是 Jest 默认 5 秒超时和你的异步逻辑没对齐。IDE 只是把原生 Jest 错误透传出来，容易让人误以为是配置问题。
- 临时验证：在测试文件顶部加
jest.setTimeout(10000) - 检查是否混用
async it()和done()——二者只能选其一；若用了async，函数体里必须return一个 Promise - WebStorm 的 “Run” 是全新进程，不继承终端里
jest --watch的 mock 状态或环境变量，调试前先确认逻辑本身在 CLI 下能稳定通过
覆盖率（Coverage）点不动或报错
覆盖率不是开个开关就能出图的，它卡在三处：Jest 配置、输出路径权限、WebStorm 解析能力。
- 确保
jest.config.js里没设collectCoverage: false，且coverageDirectory指向可写目录（如默认的coverage） - 如果用了
transform（比如ts-jest），要确认setupFilesAfterEnv引入的初始化脚本没抛错——这类错误 WebStorm 往往静默吞掉，只显示覆盖率无数据 - WebStorm 的 Coverage 视图依赖 Jest 生成的
coverage/coverage-final.json，若该文件不存在或格式异常，面板就空着
真正麻烦的不是配置步骤，而是这些环节之间没有明确报错提示——一个路径写错、一个插件没装、一个 promise 忘 return，都会让覆盖率“看起来像没启用”，其实它早就失败在第一步了。
