VSCode跑不动Jest测试，90%是jest命令本身在终端无法执行，需确保npx jest --version能输出版本号，并在settings.json中配置"jest.jestCommandLine":"npx jest"；调试断点失效主因是未设--runInBand、sourceMap与inlineSources未同时开启，且testMatch未覆盖测试文件路径。
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 映射没对齐——断点静默失效，不会报错，只会假装看不见。
-
--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}'] - 确保
jest.config.js在项目根目录，且插件能读到——orta.vscode-jest对jest.rootPath很敏感，.vscode/settings.json中设为："jest.rootPath": "./" - 重启 VSCode（不是重载窗口），彻底退出再打开，否则旧缓存可能干扰文件发现
- 如果用了
pnpm工作区或多包结构，确认jest.rootPath指向的是含jest.config.js和node_modules的子包根目录
最易忽略的其实是三者必须同时成立：launch.json 里的 --runInBand、tsconfig.json 的双 source map 开关、插件对 jest.config.js 路径的准确定位——少一个，断点就静默消失，连错误提示都不会给。
