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。
