VSCode 不显示 Jest 覆盖率是因插件未启用 coverageEnabled 或 Jest 未输出 lcov.info；需配置 collectCoverage: true、coverageProvider: "v8"、coverageDirectory: "coverage"，并安装官方 Jest 插件且开启 jest.coverageEnabled。
为什么 Jest 配置后 npm test 能跑，但 VSCode 里不显示覆盖率？
VSCode 本身不内置 Jest 覆盖率可视化能力，它依赖插件（如 Jest Runner 或 Wallaby.js）+ 正确的 Jest 配置协同工作。最常见的情况是：Jest 命令行能生成 coverage/ 目录，但 VSCode 没读取或没触发它；或者插件配置路径错位，找不到 jest.config.js 或 package.json 中的 jest 字段。
关键点在于：VSCode 插件默认不会自动开启覆盖率报告渲染，必须显式启用并确保 Jest 输出了 lcov 或 text-summary 格式。
- 确认项目根目录有可被识别的 Jest 配置文件（
jest.config.js、jest.config.cjs、或package.json中的"jest"字段） - 在
jest.config.js中至少包含collectCoverage: true和coverageDirectory: "coverage" - 安装官方推荐插件：
Jest（Orta Therox 维护，ID:orta.vscode-jest），不是“Jest Runner”等旧版替代品 - 插件启动后，右下角状态栏会出现
Jest图标，点击可手动触发重载或切换运行模式
如何让 VSCode 实时高亮未覆盖代码行？
VSCode 的 Jest 插件默认只提供测试状态（通过/失败）和终端输出，**不直接染色源码行**。要实现“行级覆盖率高亮”，必须配合 jest 的 coverageProvider + 插件的 coverageEnabled 设置，并确保生成了 lcov.info 文件。
- 在
jest.config.js中添加：collectCoverage: true,<br>coverageProvider: "v8", // 必须设为 "v8"（Node 14+ 默认），不能是 "babel"
- 在 VSCode 工作区设置（
.vscode/settings.json）中启用："jest.coverageEnabled": true,<br>"jest.autoEnable": true
- 确保
coverageDirectory路径存在且可写，插件会从该目录下的lcov.info解析行覆盖数据 - 首次启用后需手动运行一次测试（快捷键
Cmd+Shift+P→Jest: Start Runner），插件才会拉起 watcher 并开始解析
jest --watch 和 VSCode 插件的实时性冲突怎么办？
VSCode 的 Jest 插件底层就是调用 jest --watch，如果项目里手动开了另一个 jest --watch 进程，会导致端口占用、文件监听重复、覆盖率缓存错乱——表现为：修改代码后不重新跑测试、覆盖率数字卡住、甚至插件报错 Cannot find module 'jest-cli'。
- 关掉终端里所有手动运行的
jest进程（Ctrl+C彻底终止） - 检查
package.json的scripts，避免"test:watch": "jest --watch"被误触发 - VSCode 插件有自己的 watcher，无需额外配置
jest --watchAll或--watchPath - 若仍卡住，尝试在命令面板执行
Jest: Restart Runner，比关插件再开更可靠
覆盖率数字对不上？检查这三处硬编码路径
VSCode 插件读取覆盖率时，会按固定逻辑查找 lcov.info，一旦路径与 Jest 实际输出不一致，就显示 “0%” 或空白。这不是插件 bug，而是配置脱节。
- Jest 配置中
coverageDirectory: "./coverage"和插件实际扫描路径必须一致；插件默认只认项目根下的coverage/lcov.info，不支持嵌套子目录如coverage/unit/lcov.info - 若使用了
collectCoverageFrom，确保 glob 模式匹配的是源码路径（如"src/**/*.{js,ts}"），而非构建后路径 - TS 项目注意：若
ts-jest版本 ≥29，需显式加isolatedModules: false到ts-jest配置里，否则覆盖率统计会漏掉类型声明行
覆盖率不是一配就灵，尤其跨 TS/Babel/ESM 场景，coverageProvider、sourceMaps、rootDir 三个字段稍有偏差，整条链路就断在解析环节。
