vscode 代码覆盖率高亮依赖外部工具生成标准报告文件（如 lcov.info）并由插件读取映射，常见问题为报告未生成、路径不匹配或格式不支持；需确保测试命令含覆盖率参数、路径严格一致、插件配置正确。

VSCode 本身不生成、不解析、也不渲染代码覆盖率数据——所有“颜色标记”都依赖外部测试工具产出的报告文件，再由插件读取并映射到编辑器 gutter 区。装了插件却没反应？八成是报告没生成、路径不对，或格式不匹配。

Coverage Gutters 显示空白？先确认 lcov.info 是否真实存在

Coverage Gutters 是个纯读取型插件，它不会运行测试、不调 Jest/Vitest/pytest，只认 lcov.info（默认）或少数几种标准格式（如 cobertura.xml）。常见失败场景：

• 运行了 npm test，但没加 --coverage 参数 → coverage/lcov.info 根本没生成
• Jest 配置里漏了 collectCoverage: true 或 coverageReporters: ['lcov']
• Vitest 默认输出 coverage/vitest-coverage.json，而 Coverage Gutters 不支持该格式，得改配置：coverage: { reporter: ['lcov'] }
• Python 用 pytest --cov 但没加 --cov-report=xml，Coverage Gutters 读不到 .coverage 二进制文件

手动验证方法：终端执行 npx jest --coverage 或 pytest --cov=. --cov-report=xml，然后检查项目根目录下是否出现 coverage/lcov.info 或 coverage.xml。

行号旁没颜色？重点检查路径匹配逻辑

插件靠比对 lcov.info 中的 SF: 行（source file path）和你在 VSCode 中打开的文件路径做映射。哪怕差一个 ./、大小写不一致、斜杠方向不同（Windows vs WSL），都会导致整行失联。

• 打开 coverage/lcov.info，搜索你当前编辑的文件名，看 SF: 后面写的路径是不是和编辑器左下角显示的路径完全一致
• Monorepo 或 pnpm/bun 项目中，SF: 可能指向符号链接真实路径，而 VSCode 打开的是 workspace 相对路径 → 需用 sed 临时修正，或改用 Wallaby.js
• TypeScript 项目注意 tsconfig.json 的 outDir 和 rootDir，覆盖率工具依赖原始 .ts 路径，不是编译后 JS

路径错配时，你会看到状态栏有覆盖率数字（如 Coverage: 72%），但编辑器 gutter 一片空白——这是最典型的“路径不匹配”信号。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

怎么让覆盖率随保存自动刷新？别依赖右键菜单

VSCode 自带的“运行测试”右键菜单（来自 Jest / Python Test Explorer 插件）默认不会触发 Coverage Gutters 刷新。必须显式绑定：

• 在 .vscode/tasks.json 中定义一个测试任务，设 "isBackground": true，并配上 problemMatcher
• 用命令面板（Ctrl+Shift+P）手动执行 Coverage Gutters: Refresh（最快捷）
• 启用 Coverage Gutters: Watch Coverage，它会监听 coverage/lcov.info 文件变化，但仅限该文件被覆盖写入（不是追加）

注意：Coverage Gutters: Show Coverage 是一次性加载命令，后续报告更新后必须重新执行 Refresh，否则颜色永远停留在旧快照。

Go 项目怎么搞？vscode-go 自带支持，但参数不能省

Go 不需要 Coverage Gutters。vscode-go 扩展原生支持覆盖率高亮，但前提是 go test 必须生成有效的 coverage.out：

• 工作区必须在 go.mod 所在目录打开，且含 *_test.go 文件
• 必须加 -coverprofile=coverage.out -coverpkg=./ -covermode=count，缺一不可
• -coverpkg=./ 确保覆盖所有子包；-covermode=count 才支持分支统计，set 模式只标“执行过/没执行过”
• 生成后，必须手动运行命令面板里的 Go: Toggle Test Coverage，否则 gutter 不染色

灰色行不等于未覆盖——空行、注释、不可插桩语句（如 defer 后的函数调用）也会显示为灰色，要看函数级统计才准。

真正卡住人的从来不是插件装没装，而是测试命令有没有真正产出可被识别的报告，以及报告里的路径能不能和编辑器里打开的文件严丝合缝对上。路径问题在跨平台、monorepo、符号链接环境下尤其隐蔽，建议每次配置完都打开 lcov.info 手动核对一次 SF: 行。