怎么在VSCode中进行单元测试_VSCode Jest测试框架配置与运行测试教程-VSCode-PHP中文网

vscode本身不运行测试，仅调用本地jest执行；插件失效、断点不生效、测试不可见，90%因jest命令终端无法运行或testmatch配置错误、缺少--runinband参数。

怎么在vscode中进行单元测试_vscode jest测试框架配置与运行测试教程

VSCode 本身不运行测试，它只是把命令转给 Jest 执行；插件点不动、断点不生效、找不到测试，90% 是因为 jest 命令在终端里就跑不通，或者配置没对齐。

确认 jest 命令能在终端里直接运行

这是所有后续操作的前提。VSCode 插件（比如 orta.vscode-jest）本质就是调用你本地的 jest 可执行文件，它不会帮你装 Jest，也不会自动读取 package.json 脚本。

在 VSCode 集成终端中执行 npx jest --version，必须能输出版本号（如 29.7.0）
如果报错 command not found: jest，说明没装或没装对：运行 npm install --save-dev jest @types/jest
别依赖全局 npm install -g jest —— 插件默认找项目级 node_modules/.bin/jest，全局安装常导致版本错乱或路径找不到
用 pnpm？改用 pnpx jest --version；用 yarn？用 yarn jest --version

testMatch 必须匹配你的测试文件名和位置

VSCode 测试面板（Test Explorer）和 orta.vscode-jest 都靠 jest.config.js 里的 testMatch 扫描文件。配错就等于“看不见”测试，图标不亮、右键没菜单、点运行没反应。

VSCode

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

下载

默认值 ["**/__tests__/**/*.[jt]s?(x)", "**/?(*.)+(spec|test).[jt]s?(x)"] 不会匹配 src/components/Button.unit.tsx 或 tests/Api.test.ts
如果你的测试文件后缀是 .unit.tsx，加一条："**/*.unit.{ts,tsx}"
如果你把测试全放在 src/tests/ 下，改成："<rootdir>/src/tests/**/*.{test,spec}.{js,ts,tsx}"</rootdir>
别同时写 testMatch 和 testRegex —— testMatch 优先级更高，后者会被忽略

调试单个测试时必须加 `--runInBand`

Jest 默认多进程并行跑测试，而 VSCode 的 Node.js 调试器只能 attach 到主进程。不加 --runInBand，断点基本不会触发，或者只在某个子进程里静默停住，你根本看不到。

不要依赖插件“自动加参数”——手动写进 .vscode/launch.json 才可靠：

{
  "type": "node",
  "request": "launch",
  "name": "Debug Jest Tests",
  "program": "${workspaceFolder}/node_modules/.bin/jest",
  "args": ["--runInBand", "--testNamePattern", "should render button"],
  "console": "integratedTerminal"
}

jest.config.js 中如果有 maxWorkers，务必设为 1 或删掉，否则和 --runInBand 冲突

TS 项目还必须确保 tsconfig.json 同时开启："sourceMap": true 和 "inlineSources": true

点 “Debug Test” 没反应？先打开 Output → Testing 看它实际发了什么命令，复制到终端手动执行，错误信息更直接

插件组合不能装错或漏装

VSCode 的 Test Explorer 是通用 UI 层，真正干活的是框架专用 adapter。装错一个，图标灰色、“No test provider registered”，点击完全无响应。

Jest 用户：必装 ms-vscode.test-adapter-converter + hbenl.vscode-test-explorer + orta.vscode-jest（轻量）或 kavod-io.vscode-jest-test-adapter（推荐用于 Jest 29+）
Vitest 用户：装 webfreak.vitest-explorer，且 vitest 必须本地安装（npm install --save-dev vitest），不兼容 pnpm dlx vitest
Python 用户：用 ms-python.python 自带测试支持，配 python.testing.pytestArgs 即可，不用额外 adapter
装完必须彻底退出 VSCode 再重开，不是“重载窗口”——旧插件缓存可能卡住 adapter 加载