orta.vscode-jest是vscode中唯一稳定支持react+ts项目点击运行、断点调试和错误行精准跳转的官方插件；jest runner等因不兼容ts-jest的source map解析、不识别jest.config.ts及自定义roots配置，常导致点击无响应、断点停在编译后文件、堆栈无法定位源码。
VSCode 里跑 React 测试，vscode-jest（Orta 维护的官方插件）是目前唯一能稳定支持点击运行、断点调试、错误行精准跳转的方案；其他如 Jest Runner、Jest Test Explorer 在 TS/React 项目中常因 source map 或配置解析失败导致调试失效。
为什么不能用 Jest Runner 或 Test Explorer
它们在 React + TypeScript 项目中容易掉链子：点击 Run 按钮没反应、断点停在 __tests__/xxx.js 编译后文件里、报错堆栈点不进 .tsx 源码——根本原因是不兼容 ts-jest 的 source map 解析策略，也不识别 jest.config.ts 或自定义 roots 配置。
常见表现包括：
- 状态栏无 Jest 图标，或图标静止不动
- 测试文件顶部出现灰色
Run | Debug按钮但点击无输出 - 调试时断点被忽略，或停在空行 /
node_modules里
vscode-jest 安装后必须做的三件事
装完不等于能用，缺一不可：
- 重启 VSCode 窗口（不是重载窗口），否则插件不激活、不监听文件变化
- 确认项目根目录有有效的 Jest 配置：要么是
jest.config.js，要么package.json中含"jest"字段；若用jest.config.ts，需确保ts-node已安装且可执行 - 检查测试文件是否被匹配：默认只认
**/__tests__/**和**/*.test.*；React 项目常用src/components/Button.test.tsx这类路径，必须在jest.config.js中显式配置testMatch，例如：module.exports = { testMatch: ['<rootdir>/src/**/*.{test,spec}.{js,jsx,ts,tsx}'] };</rootdir>
TS 项目断点调试进不去？盯紧这两个 tsconfig.json 选项
90% 的“断点无效”问题出在这里。仅设 "sourceMap": true 不够，VSCode 调试器需要源码内联才能准确定位：
-
"sourceMap": true—— 生成.map文件 -
"inlineSources": true—— 把原始 TS 源码嵌入.map，避免路径解析失败
如果用 babel-jest，还要在 .babelrc 或 babel.config.js 中设 sourceMaps: "both"；ts-jest 用户则无需额外配 Babel。
路径和权限相关的隐形坑
vscode-jest 启动时默认调用 ./node_modules/.bin/jest，但它对包管理器很敏感：
- 用 pnpm 或 yarn v4+ 的项目，必须手动触发命令：
Ctrl+Shift+P→ 输入Jest: Start Runner，否则不启动监听 -
jest.pathToJest设置别写npx jest或yarn test—— 这些 shell 命令无法被插件正确拦截调试信号；应填相对路径如"./node_modules/.bin/jest"（Windows 注意反斜杠转义为".\node_modules\.bin\jest"） -
jest.rootPath必须设为项目根目录（如"./"），留空会导致 source map 路径解析失败，错误跳转失灵
最麻烦的是 monorepo 场景：插件可能误读 workspace 根而非 package 根，这时得在 package 级 .vscode/settings.json 里单独指定 jest.rootPath 和 jest.pathToJest。
