WebStorm 跑不起来 Jest 测试，90% 是因未显式配置 Jest 环境：需存在 jest.config.js/.ts 或 package.json 中 scripts 含 "test": "jest"；Jest package 路径应设为 Automatic 或正确相对路径（npm/yarn 用 node_modules/.bin/jest，pnpm 用 node_modules/jest/bin/jest.js）；配置变更后必须重启 IDE。
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的命令，如"test:unit": "jest"）
如果两者都缺，右键菜单里就不会有 Jest 相关项。注意：仅在 devDependencies 里装了 jest 不够，WebStorm 不会主动遍历依赖去匹配。
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 下能稳定通过
覆盖率点不动或报错
覆盖率不是开个开关就能出图的，它卡在三处：Jest 配置、输出路径权限、WebStorm 解析能力。
- 确保
jest.config.js里没设collectCoverage: false，且coverageDirectory指向可写目录（如默认的coverage） - 检查
coverage-final.json是否生成——没生成说明 Jest 根本没跑覆盖率逻辑，大概率是配置漏了--coverage或被覆盖 - WebStorm 解析覆盖率依赖 Jest 输出的 JSON 结构，如果用了自定义 reporter 或删了
coverageProvider: "v8"（v27+），可能无法渲染
真正卡住的地方往往不是“怎么点”，而是 jest.config.js 里那几行不起眼的覆盖率开关和路径设置——改完别忘了删掉 coverage/ 目录再重跑一次。
