VSCode集成Jest测试运行器教程-VSCode-PHP中文网

vscode本身不运行jest，仅调用项目级node_modules/.bin/jest；90%问题源于终端中npx jest不可执行或testmatch路径不匹配，必须先验证npx jest --version输出版本号，并在jest.config.js中正确配置testmatch及launch.json中添加--runinband参数。

vscode集成jest测试运行器教程

VSCode 本身不运行 Jest，它只是调用你项目里 node_modules/.bin/jest 这个可执行文件；插件点不动、断点不触发、测试图标不亮，90% 是因为 jest 命令在终端里根本跑不通，或者 testMatch 没配对路径。

确认 `npx jest --version` 能在终端里执行

这是所有后续操作的前提。VSCode 插件（比如 orta.vscode-jest）不会帮你装 Jest，也不会 fallback 到全局安装——它只认项目级 node_modules/.bin/jest。

在 VSCode 集成终端（Ctrl + `）中运行 npx jest --version，必须输出类似 29.7.0 的版本号
如果报 command not found: jest，运行 npm install --save-dev jest @types/jest（推荐）；别用 npm install -g jest，全局安装路径常被忽略
用 pnpm？改用 pnpx jest --version；用 yarn？用 yarn jest --version
装完后务必重启 VSCode——改了 node_modules 或 PATH，VSCode 不会自动刷新进程环境

`testMatch` 必须匹配你的测试文件路径和命名

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

VSCode 1.118

微软正式发布 Visual Studio Code 1.118 版本。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控。

下载

默认值 ["**/__tests__/**/*.[jt]s?(x)", "**/?(*.)+(spec|test).[jt]s?(x)"] 不会匹配 src/components/Button.unit.tsx 或 tests/Api.test.ts
如果你的测试后缀是 .unit.tsx，加一条："**/*.unit.{ts,tsx}"
如果你把测试全放在 tests/ 目录下，改成："<rootdir>/tests/**/*.{test,spec}.{js,ts,tsx}"</rootdir>
别同时写 testMatch 和 testRegex——testMatch 优先级更高，后者会被忽略
运行 npx jest --listTests 验证是否真能列出来；如果没输出，说明配置没生效

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

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

在 .vscode/launch.json 的 args 字段里显式加入："--runInBand"

示例配置片段：

{
  "type": "pwa-node",
  "request": "launch",
  "name": "Debug Jest Tests",
  "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/jest",
  "args": ["--runInBand", "--no-cache"],
  "console": "integratedTerminal"
}

如果用 npm test 触发，确保脚本里也带 --runInBand，例如："test": "jest --runInBand"
点 “Debug Current Test” 却执行了整个 describe 块？大概率是 Jest 版本太低（--testNamePattern；检查 Output → Testing 面板里实际发出的命令

测试没反应？先看 `Output → Testing` 面板

点击 “Run Test” 卡在 “Running…” 不是插件坏了，而是底层命令静默失败。VSCode 实际拼的是类似 npx jest --testNamePattern="should handle null" 这样的命令。

打开 Output 面板 → 切到 “Testing” 标签页，直接看真实命令和报错
常见错误包括：Unknown option: --testNamePattern（升级 Jest 到 28+）、Cannot find module 'ts-node'（TypeScript 项目漏装 ts-node）、路径含中文或空格导致 npx 找不到二进制
Windows 用户若 node_modules/.bin/jest 路径解析失败，可尝试用完整路径：node ./node_modules/.bin/jest

最易被忽略的点是：VSCode 插件从不验证 jest 是否真能执行，它只检查配置文件是否存在。哪怕 jest 完全没装，界面也可能显示“已发现 0 个测试”，然后静默失败。