VSCode中Jest单元测试与覆盖率正常运行需三者对齐：命令能执行（npx jest --version通）、报告能生成（jest.config.js设collectCoverage:true及coverageProvider:"v8"）、路径能匹配（Coverage Gutters配置正确lcov.info路径）。

jest

要在 VSCode 里真正跑起来、看得见覆盖率，关键不是装多少插件，而是三件事对齐：**命令能执行、报告能生成、路径能匹配**。缺一不可，少一个就卡在“没反应”“标不红”“数字为0”。

VSCode 点 Run 没反应？先确认 npx jest 在终端里能跑通

所有插件（vscode-jest、Test Explorer）都只是调用你本地的 jest 命令——它挂了，UI 就是灰的。

• 打开 VSCode 集成终端，执行 npx jest --version，必须输出版本号；报 command not found 或 Cannot find module 'jest'，说明 jest 没装进 node_modules（全局安装无效）
• 检查项目根目录是否有 jest.config.js 或 package.json 里含 "jest" 字段；没有配置文件，插件连默认规则都不会加载
• 测试文件命名或路径不标准（比如叫 Button.spec.tsx 或放在 src/tests/），插件默认不扫——必须在 jest.config.js 显式写 testMatch: ['/src/**/*.{test,spec}.{js,jsx,ts,tsx}']
• 改完配置后，必须完全重启 VSCode（不是重载窗口），否则缓存还在，插件仍按旧规则扫描

collectCoverage: true 不是可选项，是硬开关

默认 jest 根本不生成任何覆盖率数据，coverage/lcov.info 文件压根不存在——Coverage Gutters 再努力也读不到空文件。

• 在 jest.config.js 中必须显式启用：collectCoverage: true，同时配好 coverageDirectory: "coverage" 和 coverageReporters: ["lcov", "text-summary"]
• 加 coverageProvider: "v8"（Node 14+ 必须），"babel" 在新版 Jest 下会静默失败，导致 lcov.info 有文件但无行级数据
• 临时验证是否生效：终端执行 npx jest --coverage，看输出末尾有没有覆盖率表格；没有，就是配置漏了或路径错（比如 collectCoverageFrom 写成 src/**/*.ts 却漏了双星号）

Coverage Gutters 标不了行？大概率是路径对不上

Coverage Gutters 是个纯读取器，它只认 lcov.info 里的 SF: 行路径，和你在编辑器里打开的文件路径必须严格一致，差一个字符都不染色。

VSCode

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

下载

• 检查 coverage/lcov.info 文件是否存在，且非空；如果用了 Docker / WSL / monorepo，SF: 后面的路径可能是 /home/user/project/src/index.ts，而你 VSCode 打开的是 /Users/me/project/src/index.ts——路径前缀不一致，直接失效
• VSCode 设置中 coverage-gutters.coverageFileNames 默认是 ["lcov.info"]，但实际路径是 ./coverage/lcov.info，得手动设成 ["${workspaceFolder}/coverage/lcov.info"]
• 别指望右键“Run Test”自动刷新覆盖率标记；必须手动触发命令面板 → Coverage Gutters: Refresh，或者把测试命令配置成 task 并绑定 postTestTask

调试断点停在 JS 文件里？TypeScript 源映射没对上

Jest 实际运行的是编译后的 JS，断点要打回 .ts 源码，靠的是 sourceMap 和 inlineSources 两把锁。

• tsconfig.json 必须同时开启："sourceMap": true 和 "inlineSources": true（后者防止路径解析失败）
• jest.config.js 的 transform 规则必须覆盖 .ts 和 .tsx：'^.+\.tsx?$': 'ts-jest'，漏掉 tsx 就会跳到 React 编译结果里
• 调试时建议关掉覆盖率：collectCoverage: false，避免 ts-jest 多层处理干扰 source map 加载
• 别在 beforeEach 或异步回调里下断点——Jest 的沙盒生命周期可能让调试器跳过

真正卡住人的往往不是“怎么配”，而是环境隔离没做实：比如 jest 版本是 v29，但插件调用的却是全局 v27；又或者 ts-jest 没装、transform 没配全，导致源码根本没被正确处理——这些细节不会报错，只会让你对着空白行干瞪眼。