Orta.vscode-jest是VSCode中唯一真正可用的官方Jest扩展，支持点击运行单测、错误行定位和断点调试；需重启VSCode、配置正确路径、开启sourceMap与inlineSources，并注意Vitest项目应使用其专用插件。
VSCode里装哪个Jest扩展才真正可用
官方 Orta.vscode-jest 扩展是目前唯一能稳定支持点击运行单测、自动定位错误行、断点调试的方案。第三方“Jest Runner”或“Jest Test Explorer”在 TS 项目、自定义配置（如 jest.config.ts）下常掉链子，尤其报错时跳转不到源码行。
安装后必须重启 VSCode，否则状态栏不显示 Jest 图标，jest 命令也不会自动识别工作区配置。
- 确认项目根目录有
package.json且含"jest"脚本，或存在jest.config.js/jest.config.ts - 如果用
ts-jest，确保tsconfig.json中"compilerOptions.sourceMap"为true，否则断点会停在编译后代码上 - 扩展默认只监听
**/__tests__/**和**/*.test.*文件；若测试文件放在src/tests/下，需在jest.config.js中显式配置testMatch
点击“Run”没反应？先检查这三件事
常见现象：测试文件顶部出现灰色“Run | Debug”按钮，但点击无响应，终端无输出，状态栏 Jest 图标静止不动。
- VSCode 的
jest.pathToJest配置写错了——别直接填npx jest，应填相对路径如"./node_modules/.bin/jest"或绝对路径（Windows 注意反斜杠转义） - 项目用了 pnpm/yarn v4+，而扩展未启用
jest.autoEnable或未手动执行Jest: Start Runner命令（Ctrl+Shift+P → 输入该命令） - 测试文件未被
jest.config.js的testRegex或testMatch匹配到，可临时加一句console.log('loaded')到setupFilesAfterEnv看是否执行
断点调试进不去，90% 是 source map 没对齐
即使写了 debugger 或打了断点，VSCode 停在空行、__tests__ 外部、甚至 node_modules 里，基本就是 source map 映射失效。
- TS 项目必须在
tsconfig.json中同时开启："sourceMap": true和"inlineSources": true（后者让源码嵌入 map，避免路径解析失败） - 若用
babel-jest，确保.babelrc或babel.config.js中sourceMaps设为"both"或true - VSCode 的
launch.json不需要额外配——扩展内置了调试配置；但若手动加了 Node.js 调试配置，反而会冲突，删掉即可
错误堆栈点不进源码？改这个配置项
控制台报错显示 MyComponent.test.tsx:42，但点击后跳到编译后的 JS 文件或空白处，问题出在 VSCode 对 source map 的路径解析策略。
- 在 VSCode 设置中搜索
jest.rootPath，设为项目根目录（如./），不要留空 - 在
jest.config.js中加modulePaths: ['<rootdir>/src']</rootdir>，尤其当测试引用了@/utils这类别名时，否则 source map 无法还原原始路径 - 如果用 Vite + Vitest，别硬套 Jest 扩展——Vitest 自带 VSCode 插件，
Orta.vscode-jest在 Vitest 项目里会反复崩溃
真实调试时最卡壳的永远不是配置步骤，而是 source map 的生成路径和 VSCode 解析路径之间差了一个 ../ 或一个 dist/ 前缀。每次改完记得删掉 node_modules/.cache/jest 和 dist/ 重新跑一次。
