coverage gutters 插件无反应，主因是未生成或路径/格式错误的 lcov.info 报告；需显式启用覆盖率、校准文件路径、检查 vscode 设置并手动刷新。
Coverage Gutters 插件装了但没反应？先确认覆盖率报告格式
插件本身不生成覆盖率数据，只读取现有报告。如果你看到行号旁一片空白，大概率是报告没生成、路径不对，或者格式不被支持。
它默认只认 lcov.info（来自 jest --coverage、nyc、vitest --coverage 等工具的输出），不识别 coverage.json 或 clover.xml 等其他格式。
- 运行测试时必须显式开启覆盖率收集：比如
vitest --coverage，而不是只跑vitest - 确保报告输出到插件能访问的路径，默认是项目根目录下的
coverage/lcov.info - 如果用了自定义路径（如
coverage/my-report/lcov.info），需在 VSCode 设置里改coverage-gutters.coverageReportPath
行内覆盖标记不显示？检查文件路径匹配逻辑
Coverage Gutters 是靠比对报告里的 SF: 行（source file path）和你当前打开的文件路径来定位的。一旦路径不一致，哪怕只差一个 ./ 或大小写，就完全不亮。
常见陷阱：
-
lcov.info里记录的是绝对路径（如SF:/Users/you/project/src/utils.ts），但你在 VSCode 里打开的是相对路径视图 —— 插件会尝试做归一化，但 Windows 和 WSL 下容易出错 - 用
pnpm或bun跑测试时，某些覆盖率工具（如istanbul）可能因node_modules解析差异，把路径写成符号链接真实路径，导致匹配失败 - 解决方法：打开
lcov.info手动搜你正在看的文件名，看SF:后面写的路径是否和编辑器左下角显示的文件路径一致（注意斜杠方向、大小写、有无src/前缀）
VSCode 设置里哪些选项真正影响显示效果？
插件设置不多，但几个关键项直接决定你能不能看到颜色块：
-
coverage-gutters.showLineCoverage：控制是否在行号旁画小色块（绿色/红色），关了就只剩状态栏统计 -
coverage-gutters.showWorkspaceCoverage：决定状态栏是否显示整体覆盖率数字，不影响编辑器内高亮 -
coverage-gutters.coverageReportPath：必须指向正确的lcov.info文件，支持 glob，比如**/coverage/lcov.info可扫子包 -
coverage-gutters.useCustomColors：启用后才能通过coverage-gutters.colors自定义红/绿/黄色值，否则强制用默认色板
修改后无需重启 VSCode，但得手动触发刷新：按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Win/Linux），输入 Coverage Gutters: Refresh 回车。
为什么有些行标绿了，但实际没被测到？别信颜色，信报告本身
Coverage Gutters 的着色逻辑是“只要该行在 DA: 行里出现过且命中次数 > 0 就标绿”，但它不验证这行是不是真的执行路径上的有效语句。比如：
- TS 编译后的
__awaiter辅助函数行，可能被计入但不属于你的源码逻辑 - 带条件编译的代码（如
process.env.NODE_ENV === 'test'）在覆盖率运行时环境不同，可能导致误标 - 异步回调里延迟执行的行，若测试没等完就结束，
lcov.info可能仍记为已覆盖（取决于工具实现）
所以颜色只是快速视觉提示，真要确认覆盖质量，还得点开 HTML 报告（通常在 coverage/index.html），那里有逐行可点击的详细执行次数统计。
最常被忽略的一点：插件不会自动监听 lcov.info 文件变化 —— 你改完测试重新跑完，得手动按一次刷新命令，否则编辑器里还是旧状态。
