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: ['<rootdir>/src/**/*.{test,spec}.{js,jsx,ts,tsx}']</rootdir> - 改完配置后，必须完全重启 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: 行路径，和你在编辑器里打开的文件路径必须严格一致，差一个字符都不染色。
- 检查
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 没配全，导致源码根本没被正确处理——这些细节不会报错，只会让你对着空白行干瞪眼。 
