VSCode如何运行和调试Jest单元测试-VSCode-PHP中文网

vscode跑不动jest测试，90%是jest命令本身在终端无法执行，需确保npx jest --version能输出版本号，并在settings.json中配置"jest.jestcommandline":"npx jest"；调试断点失效主因是未设--runinband、sourcemap与inlinesources未同时开启，且testmatch未覆盖测试文件路径。

vscode如何运行和调试jest单元测试

VSCode 跑不动 Jest 测试，90% 不是插件坏了，而是 jest 命令本身在终端里就跑不起来——插件只是调用它，它挂了，UI 再漂亮也没用。

为什么点“Run Test”没反应或报 Command failed: jest

常见现象：测试文件旁没出现运行图标、点击无响应、Output → Testing 里显示类似 Command failed: jest --json --useStderr --outputFile=/tmp/jest_runner.json 的错误。

根本原因是 VSCode 插件（如 orta.vscode-jest）默认尝试用全局 jest，但你项目实际靠 npx jest 或 yarn jest 调用本地 node_modules/.bin/jest
先在集成终端里手动执行 npx jest --version，必须能输出版本号；不行就重装：npm install --save-dev jest
检查 package.json 是否有有效 "test" 脚本，比如 "test": "jest"，否则插件可能跳过识别
在 .vscode/settings.json 中明确指定："jest.jestCommandLine": "npx jest"（pnpm 项目用 "pnpx jest"，yarn 用 "yarn jest"）

调试时断点不命中，总停在空行或 tests/xxx.js

这不是断点打错了，是 Jest 进程模型和 source map 映射没对齐——断点静默失效，不会报错，只会假装看不见。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

--runInBand 是硬性前提：Jest 默认多进程并行，而 VSCode 调试器只能 attach 主进程。不加这个参数，断点大概率不触发

launch.json 必须显式配置，别依赖插件自动生成：

{
  "type": "node",
  "request": "launch",
  "name": "Debug Jest Tests",
  "program": "${workspaceFolder}/node_modules/.bin/jest",
  "args": ["--runInBand", "--no-cache"],
  "console": "integratedTerminal",
  "internalConsoleOptions": "neverOpen"
}

TypeScript 项目还必须同时开启 tsconfig.json 中的："sourceMap": true 和 "inlineSources": true；只开一个没用
别在 beforeEach、setupFilesAfterEnv 里 throw 错误——调试启动阶段就崩了，断点根本没机会加载

测试文件没被识别，侧边栏显示 “No tests found”

Orta.vscode-jest 默认只扫描 **/*.test.* 和 **/__tests__/** 下的文件。你的测试叫 Button.unit.tsx 或放在 src/tests/？那它压根不会进扫描范围。

在 jest.config.js 中显式配 testMatch，例如：
testMatch: ['<rootdir>/src/**/*.{test,spec}.{js,jsx,ts,tsx}']</rootdir>
确保 jest.config.js 在项目根目录，且插件能读到——orta.vscode-jest 对 jest.rootPath 很敏感，.vscode/settings.json 中设为："jest.rootPath": "./"
重启 VSCode（不是重载窗口），彻底退出再打开，否则旧缓存可能干扰文件发现
如果用了 pnpm 工作区或多包结构，确认 jest.rootPath 指向的是含 jest.config.js 和 node_modules 的子包根目录