vscode覆盖率颜色不显示，主因是lcov.info未生成、路径不匹配或格式不支持；需确保jest/vitest显式启用collectcoverage与lcov reporter，且sf路径与编辑器文件路径完全一致。

VSCode 里看不到覆盖率颜色，基本不是插件没装，而是 lcov.info 没生成、路径对不上，或者测试根本没跑出有效覆盖率数据——Coverage Gutters 只读不跑，它连 Jest 都不调用。

为什么 Coverage Gutters 显示空白或报 “no coverage data”

它只扫描你指定路径下的报告文件，不做任何转换或兜底。常见断点：

• coverage/lcov.info 文件根本不存在：终端进项目根目录执行 ls coverage/lcov.info，空则说明测试没带覆盖率参数运行
• Jest 配置漏了 collectCoverage: true，只靠 package.json 里的 --coverage 不够稳，vscode-jest 插件可能忽略
• Vitest 默认输出 coverage/vitest-coverage.json，Coverage Gutters 不认这个格式，必须显式配 reporter: ['lcov']
• 路径写错：比如 coverage-gutters.lcovname 设成 "coverage/coverage.lcov"，但实际是 "coverage/lcov.info"

让 Jest 正确生成 lcov.info 的硬性条件

不是“跑测试”，而是“带正确参数跑测试”。关键配置必须同时满足：

• jest.config.js 中必须有 collectCoverage: true（不能只靠命令行参数）
• coverageProvider: "v8" —— Node 14+ 环境下设成 "babel" 会导致 lcov.info 里 DA: 行为空，行级数据全丢
• coverageReporters: ["lcov", "text-summary"]，缺 "lcov" 就不写 lcov.info
• collectCoverageFrom 路径要能匹配到源文件，比如 "src/**/*.{js,ts}"，写成 "src/*.ts" 会漏掉子目录

验证方式：终端直接执行 npx jest --collectCoverage --coverageReporters=lcov，看是否生成 coverage/lcov.info 并且文件非空。

Zenlink - Node SDK for ZenHeart

ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。

下载

VSCode 路径匹配失败的典型表现和修复

状态栏显示 “Coverage: 72%”，但 gutter 区全白？这是路径映射失败的铁证。Coverage Gutters 用 lcov.info 里的 SF: 行（源文件路径）和编辑器当前打开文件的绝对路径做比对，差一个斜杠或大小写都不行。

• 打开 coverage/lcov.info，搜索你正在编辑的文件名，看 SF: 后面写的路径是否和 VSCode 左下角显示的路径完全一致（包括 / 还是 \、大小写、有没有 ./）
• 如果路径含 node_modules 或符号链接，SF: 可能写的是真实物理路径，而 VSCode 打开的是 symlink 路径，两者不等价
• 多根工作区下，每个文件夹需单独配置 coverage-gutters.coverageFileNames，不能只在全局设置里填一个路径
• 路径配置中不要以 ./ 开头，填 "coverage/lcov.info" 或 "${workspaceFolder}/coverage/lcov.info" 即可

自动刷新覆盖率不是默认开启的

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

• 确保测试命令稳定输出 lcov.info（比如 npm run test:coverage）
• 在 tasks.json 中定义一个 type: "shell" 任务，command 指向该脚本，并设 "problemMatcher": []
• 加 "group": "build" 和 "presentation": { "echo": false, "reveal": "never", "panel": "shared" }
• 最后在 settings.json 里启用 "coverage-gutters.autoRefresh": true，它才会监听任务完成事件自动 reload

注意：Vitest 用户若用 vitest --coverage reporter=lcov 临时验证没问题，但长期必须把 reporter: ['lcov'] 写死在 vitest.config.ts 里，否则 watch 模式下不会持续更新 lcov.info。