如何在VSCode中通过Node环境自动采集本地项目代码覆盖率数据-VSCode-PHP中文网

vscode本身不采集覆盖率数据，必须由jest/vitest等框架生成lcov.info，再由coverage gutters等插件读取渲染；关键在于确保collectcoverage:true、reporter设为lcov、路径匹配且手动或任务自动刷新。

如何在vscode中通过node环境自动采集本地项目代码覆盖率数据

VSCode 本身不采集覆盖率数据，必须靠 Node 测试框架（如 Jest/Vitest）生成 lcov.info，再由插件读取渲染。自动采集的关键是让测试命令稳定输出标准报告，并与 Coverage Gutters 绑定刷新。

很多人跑 npm test 看到终端有覆盖率数字，但 VSCode 侧边栏没颜色——问题通常出在 Jest 配置或命令参数上：

jest.config.js 中必须显式设 collectCoverage: true，不能只依赖 package.json 脚本里的 --coverage；否则 vscode-jest 插件可能忽略覆盖率收集
Node 14+ 环境下，coverageProvider 必须为 "v8"，写成 "babel" 会导致 lcov.info 里没有行级数据（DA 行为空）
coverageDirectory 建议固定为 "coverage"，避免写成 "./out/coverage" 这类非标准路径——Coverage Gutters 默认只查 coverage/lcov.info
运行命令必须带 --coverageReporters=lcov，否则 Jest 默认只生成 HTML 和 text-summary，不写 lcov.info

Vitest 默认输出 coverage/vitest-coverage.json，而 Coverage Gutters 不支持该格式，直接导致“no coverage data found”：

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

在 vitest.config.ts 中必须配置：coverage: { reporter: ['lcov'] }，不能只写 reporter: 'lcov'（类型错误）
若已存在 coverage/vitest-coverage.json，先手动删掉它，否则 Coverage Gutters 可能误读旧文件并报错
命令行运行时加 vitest --coverage reporter=lcov 是临时验证手段，但长期应以 config 文件为准
注意 all: true 选项会影响覆盖率统计范围——未被 test 文件 import 的模块不会被插桩，即使写了 collectCoverageFrom

按 Ctrl+Shift+P → “Coverage Gutters: Refresh” 手动刷一次很轻松，但开发中频繁切换文件后容易忘——真自动得靠 tasks.json：

在 .vscode/tasks.json 中定义一个 type: "shell" 任务，命令为 npm run test:coverage 或 vitest --coverage
设 "isBackground": true 并配 "problemMatcher"（如 "$tsc-watch" 或自定义正则），否则 VSCode 不认为任务“完成”，不会触发后续动作
在 launch.json 的 preLaunchTask 或 postLaunchTask 中引用该任务，即可在调试启动/结束时自动刷新覆盖率
别依赖右键菜单“Run Test”——它调用的是 vscode-jest 或 Test Explorer 的内部逻辑，不会通知 Coverage Gutters

染色失败最隐蔽的原因：覆盖率文件记录的源码路径和编辑器里打开的文件路径对不上。比如：

lcov.info 里写的是 SF:/Users/me/project/src/index.ts，但你在 VSCode 里打开的是 src/index.ts（相对路径）
TypeScript 项目中，tsconfig.json 的 outDir 若设为 "dist"，而 include 没包含 .ts 源文件，Jest/Vitest 就会基于编译后路径生成 SF:，导致匹配失败
多根工作区（workspace folder）下，每个子项目需单独配置 coverage-gutters.coverageFileNames，否则插件只查第一个根目录
检查 lcov.info 文件头部几行，确认 SF: 后的路径是否真实存在、是否拼写一致（大小写敏感！Linux/macOS 下尤其关键）