VSCode中运行Jest测试的关键是确保jest命令可在终端正常执行，插件仅调用它；需配置"jest.jestCommandLine"为"npx jest"等，并正确设置ts-jest、source map及调试配置。

VSCode 里跑 Jest 测试，核心不是装插件，而是让 jest 命令本身能在终端里正常执行；插件只是调用它，它挂了，插件再 fancy 也没用。

为什么 npm test 能跑，但 VSCode 插件点不动？

常见现象：点击测试旁的“运行”图标没反应，或者报错 Command failed: jest --json --useStderr --outputFile=/tmp/jest_runner.json...。本质是 VSCode 的 Jest 插件（如 Orta.vscode-jest）默认尝试用全局 jest，但你项目里其实是靠 npm run test 或 npx jest 调用本地 node_modules/.bin/jest 的。

• 检查项目根目录是否有 package.json 且含 "test": "jest" 脚本
• 在 VSCode 集成终端里手动运行 npx jest --version，确认能输出版本号
• 打开 VSCode 设置（settings.json），加这一行：

  "jest.jestCommandLine": "npx jest"

• 如果项目用 pnpm/yarn，改成 "jest.jestCommandLine": "pnpx jest" 或 "yarn jest"

调试单个测试文件时断点不生效？

VSCode 默认用 --runInBand 模式启动 Jest，但若项目配置了 testEnvironment: 'jsdom' 或用了 setupFilesAfterEnv，Node.js 调试器可能无法正确注入源映射（source map）。

VSCode

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

下载

• 确保 jest.config.js 含 collectCoverage: false（调试时关掉覆盖率，减少干扰）
• 在 .vscode/launch.json 中配一个 Node.js 启动配置，而不是依赖插件自动调试

  {
    "type": "node",
    "request": "launch",
    "name": "Debug Jest Tests",
    "runtimeExecutable": "npx",
    "runtimeArgs": ["jest", "--runInBand", "--no-cache"],
    "console": "integratedTerminal",
    "internalConsoleOptions": "neverOpen"
  }

• 别在 beforeEach 或异步回调里下断点——Jest 的测试生命周期钩子运行在沙盒中，调试器可能跳过

TS + Jest 配置后提示 “Cannot find module”？

不是 TypeScript 编译问题，而是 Jest 没加载 ts-jest 预处理器，或 jest.config.js 的 transform 规则没覆盖 .ts 文件。

• 确认已安装：npm install --save-dev ts-jest @types/jest
• jest.config.js 必须有：

  module.exports = {
    transform: {
      '^.+\.tsx?$': 'ts-jest'
    },
    testRegex: '(/__tests__/.*|(\.|/)(test|spec))\.(jsx?|tsx?)$',
    moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node']
  };

• 删掉 node_modules 和 jest.config.js 旁的 jest.config.ts（如果存在）——Jest 不会自动识别 TS 格式的配置文件

最常被忽略的是：Jest 插件不会帮你装 jest，也不会读取 npm scripts 里的环境变量（比如 NODE_OPTIONS=--experimental-vm-modules）。所有和执行环境相关的东西，得先在终端里验证通了，再让插件去调用它。