WebStorm 调试 Jest/Mocha 的前提是正确配置 Node.js 解释器、测试框架入口路径及文件识别规则：需手动指定 node 可执行路径，Jest 配置文件或 package.json 中 jest 字段须匹配，Mocha 需启用 Recursive 并设对 Test directory，文件名须为 .test.js 或 .spec.js，TypeScript 测试需配 ts-jest 与正确 transform 规则。
WebStorm 能直接运行和调试 Jest 或 Mocha，但前提是它得“认出”你的测试框架——不是装了 jest 就自动生效，关键在配置是否对得上 Node.js 环境、入口路径和文件识别规则。
确认 Node.js 解释器已正确识别
WebStorm 不会自己猜你用的是哪个 Node 版本。如果 Run 按钮灰掉、或者点开 Run → Edit Configurations 时看不到 Jest/Mocha 选项，第一件事就是检查解释器：
- 进入
File → Settings → Languages & Frameworks → Node.js and NPM - 右侧
Node interpreter字段必须指向一个真实可执行的node（比如/usr/local/bin/node或 Windows 下的C:Program Files odejs ode.exe） - 如果显示
Not configured或路径红标，手动点击...选中本地安装的 Node - 别依赖 WebStorm 自动探测——某些包管理器（如 Bun 或 nvm 切换环境后）容易让它失联
Jest 配置必须匹配项目实际入口
WebStorm 启动 Jest 时，本质是调用 node node_modules/jest/bin/jest.js 并传参。它需要知道从哪读配置、跑哪些文件：
-
Jest package字段：优先填绝对路径到node_modules/jest/bin/jest.js；若为空，WebStorm 可能 fallback 到全局 Jest（极易版本错乱） -
Jest configuration file字段：jest.config.js存在就填完整路径；若只在package.json里写"jest": {...}，这项留空即可 -
Working directory必须设为项目根目录（即含package.json的那层），否则moduleNameMapper或setupFilesAfterEnv里的相对路径全失效 - 常见报错
Cannot find module 'xxx' from 'xxx.test.js'，八成是工作目录设错了，而不是模块没装
Mocha 需显式指定测试目录与递归开关
Mocha 不像 Jest 那样默认扫 **/*.test.js，WebStorm 的 Mocha 运行配置里漏掉关键项就会“找不到测试”：
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
立即学习“前端免费学习笔记（深入）”；
-
Test directory填的是目录路径（如src/__tests__或test），不是 glob 表达式 - 务必勾选
Recursive，否则子目录里的utils/parse.test.js直接被忽略 - 若测试文件用
.spec.js后缀，要在Test files pattern里改成*.spec.js（默认是*.test.js） - 不推荐用 Mocha +
babel-register方式跑 ES6+ 代码——WebStorm 调试时容易卡在 require hook 上；改用esbuild-node或直接转译后测试更稳
断点不命中？先看文件名和 inspections 设置
即使配置全对，边距上没出现红色断点图标，大概率是 WebStorm 根本没把那个文件当“测试文件”处理：
- 文件名必须符合 WebStorm 内置识别规则：
*.test.js、*.spec.js、__tests__/**/*.js（注意双下划线） - 进
Settings → Editor → Inspections → JavaScript → General → Unreachable code，确认没误关Test file detection相关检查项 - TypeScript 测试必须配
ts-jest，且jest.config.js中transform项不能漏掉^.+\.(t|j)sx?$，否则 WebStorm 调试时看到的是 .ts 源码，但实际执行的是未转换的 JS，断点位置完全错位 - 异步测试（
async test()）里设断点，要确保jest.setTimeout(10000)已设，否则超时退出前断点根本没机会触发
最常被忽略的一点：WebStorm 的 Jest/Mocha 集成高度依赖 node_modules 里对应包的完整性。删过 node_modules 或换过包管理器（npm/yarn/pnpm/bun）后，必须重启 WebStorm——它的运行配置缓存不会自动刷新，旧的 Jest package 路径可能还指着已被删掉的目录。
