WebStorm不会自动识别Jest，必须满足两个条件之一：项目根目录存在jest.config.js/.ts，或package.json中scripts含"test": "jest"；否则右键无“Run Jest”选项，Jest package路径须设为node_modules/.bin/jest（npm/yarn）或node_modules/jest/bin/jest.js（pnpm），填绝对路径或未重启IDE均会导致失败。
WebStorm 不会自动识别 Jest，必须显式提供“凭证”才能激活测试运行器——没配对就右键不出 Run Jest，不是 IDE 坏了，是它根本没启动 Jest 支持。
为什么右键没有 “Run Jest” 选项
WebStorm 只认三种“存在证明”，缺一不可：
- 项目根目录下存在
jest.config.js或jest.config.ts -
package.json的scripts中定义了"test": "jest"（值可以带参数，如"jest --verbose"） - 两者都没有时，WebStorm 会生成默认配置，但此时无法读取你自定义的
setupFilesAfterEnv、transform等，测试很可能静默失败
注意：devDependencies 里装了 jest 不等于 WebStorm 能识别——它不扫描 node_modules，只看这两个“凭证”文件。
Jest package 路径填错导致 Cannot find module 'jest-cli'
这个报错 95% 是因为路径指向了全局 Jest，而项目用的是本地版本。WebStorm 的 Jest package 字段必须精确匹配项目实际入口：
- npm / yarn 项目：填
node_modules/.bin/jest（相对路径，不是绝对路径） - pnpm 项目：
node_modules/.bin/jest往往是坏链接，应改用node_modules/jest/bin/jest.js - 绝对路径（如
/usr/local/bin/jest）基本必挂，尤其跨 Node 版本或使用 nvm 时 - 推荐勾选
Automatic模式，让 WebStorm 自动解析本地node_modules，但改完必须重启 WebStorm 才生效
单个 it() 报 Timeout - Async callback was not invoked
这不是 WebStorm 配置问题，是 Jest 默认 5 秒超时和你的异步逻辑没对齐。IDE 只是透传原生错误：
- 临时验证：在测试文件顶部加
jest.setTimeout(10000) - 检查是否混用
async it()和done()——二者只能选其一；若用了async，函数体里必须return一个 Promise - WebStorm 的
Run是全新进程，不继承终端中jest --watch的 mock 状态或环境变量，调试前先确认逻辑本身在 CLI 下能稳定通过
覆盖率点不动或报错
覆盖率不是开关一开就出图，它卡在三处：Jest 配置、输出路径权限、WebStorm 解析能力：
- 确保
jest.config.js里没设collectCoverage: false，且coverageDirectory指向可写目录（如默认的coverage） - WebStorm 的覆盖率开关在运行配置里：
Run → Edit Configurations → 勾选 Enable coverage，不是在 Jest 配置文件里 - 运行后必须手动打开
Run → Show Code Coverage Data（快捷键Ctrl+Alt+F6），并确认对应套件已设为Active - 如果用了 TypeScript，
collectCoverageFrom必须包含**/*.ts，否则 .ts 文件不会被计入
最常被忽略的是：WebStorm 不会自动刷新覆盖率数据——改了源码但没重跑测试，编辑器里的红绿高亮就是滞后的。关掉覆盖工具窗口再重跑一次，或点 Re-run with coverage。
