vscode不生成或解析覆盖率数据，仅读取并渲染已有报告；需测试框架生成lcov.info（或xml）且插件路径配置正确。常见问题包括未运行测试、配置遗漏collectcoverage、路径错误、多根工作区未单独配置等。
VSCode 本身不生成也不解析覆盖率数据，它只负责读取已有报告并渲染颜色标记。想在编辑器里看到绿/黄/红行标记，必须满足两个硬条件：测试框架已成功生成 lcov.info（或 XML），且插件配置路径能准确找到它。
为什么 Coverage Gutters 没反应？常见断点在这里
插件不会帮你跑测试，也不会自动生成报告——它只是个“显示器”。你看到空白、灰色标记、或者报错 Cannot find coverage file，大概率是下面某个环节没打通：
- 没运行过测试，
coverage/lcov.info根本不存在（检查目录是否存在、是否为空） -
jest.config.js里漏了collectCoverage: true或coverageReporters: ["lcov"] - VSCode 工作区设置中
coverageGutters.coverageFileNames指向了错误路径，比如写成"coverage/coverage.lcov"而实际是"coverage/lcov.info" - 项目用了 Vitest，但没在
vite.config.ts里配coverage: { provider: "v8", reporter: ["lcov"] }
Jest + vscode-jest + Coverage Gutters 的最小可行配置
三者配合最稳，但参数必须对齐。尤其注意 coverageProvider 必须设为 "v8"，Node 14+ 环境下 "babel" 会静默失败，导致 lcov.info 无行级数据：
/* jest.config.js */
module.exports = {
collectCoverage: true,
coverageProvider: "v8", // 关键！不是 "babel"
coverageDirectory: "coverage",
coverageReporters: ["lcov", "text-summary"],
collectCoverageFrom: ["src/**/*.{js,ts}"]
};
同时确保 .vscode/settings.json 启用：
{
"jest.coverageEnabled": true,
"coverage-gutters.coverageFileNames": ["${workspaceFolder}/coverage/lcov.info"]
}
改完后必须手动执行一次 Jest: Start Runner（Cmd/Ctrl+Shift+P），否则 watcher 不启动，插件不会去读文件。
Python / C/C++ 项目别套用 JS 那套路径逻辑
不同语言工具链输出的覆盖率格式和默认路径差异很大，硬改 lcov.info 路径往往白忙：
- Python +
pytest-cov默认输出的是.coverage（二进制），Coverage Gutters 不认；得加--cov-report=xml生成coverage.xml，再配"coverage-gutters.coverageFileNames": ["coverage.xml"] - C/C++ +
gcovr或lcov通常输出coverage/lcov.info，但编译时必须带-fprofile-arcs -ftest-coverage，且不能开-O2以上优化，否则行号映射错乱 - VSCode 的 Python 扩展自带覆盖率按钮，点“Run Test with Coverage”会自动调
pytest --cov并尝试高亮，比手动配 Coverage Gutters 更省事
最容易被忽略的一点：所有路径配置都基于 ${workspaceFolder}，但如果你用多根工作区（multi-root workspace），coverageGutters 默认只查第一个文件夹，得手动在每个文件夹的 .vscode/settings.json 里单独指定 coverageFileNames。否则某子项目跑出了 lcov.info，插件也视而不见。
