VSCode不自动生成覆盖率数据，需测试工具（如Jest、pytest、go test）显式生成lcov.info等标准报告文件，Coverage Gutters插件仅读取并渲染，路径、格式、配置任一不匹配均导致无显示。
VSCode 里没有内置的“覆盖率开关”，coverage 数据不会自动出现——它只在你明确生成报告、插件正确读取、路径完全匹配时，才在编辑器左侧 gutter（行号旁）和状态栏显示颜色标记与百分比。
状态栏覆盖率数字点不动？先确认有没有真实报告文件
点击状态栏右下角类似 Coverage: 72% 的文字毫无反应，大概率是 coverage/lcov.info 根本没生成，或插件压根没找到它。
- 打开终端，手动运行一次完整测试：比如
npx jest --coverage（Jest）、pytest --cov=src --cov-report=xml（Python）、go test -coverprofile=coverage.out ./...（Go），然后检查对应路径是否存在非空文件 - 常见错误路径：
coverage/coverage.lcov（应为lcov.info）、out/coverage.xml（应为coverage.xml或项目根下的coverage/lcov.info） - Python 用户注意：
pytest-cov默认输出的是二进制.coverage，Coverage Gutters 不识别；必须加--cov-report=xml才能生成插件可读的格式
Coverage Gutters 显示 “No coverage data”？它不干活，只读文件
Coverage Gutters 是纯渲染层，不触发测试、不生成报告、不修正路径。报这个错，90% 是以下三者之一出问题：
-
vscode设置中coverage-gutters.coverageFileNames没配对，比如写成["coverage/coverage-final.json"]，但实际生成的是lcov.info - 多根工作区（multi-root workspace）下，每个文件夹需单独配置
.vscode/settings.json，不能只在最外层设一次 - Vitest 项目默认输出
coverage/vitest-coverage.json，而 Coverage Gutters 默认不支持该格式；要么改用vitest --coverage reporter=lcov，要么换Wallaby.js
快捷指令在哪？不是所有“运行测试”都能触发覆盖率刷新
VSCode 测试面板右键菜单里的 “Run Test” 或 Jest 插件的 “Run All Tests” 命令，默认不通知 Coverage Gutters 刷新——它只跑测试，不发信号。
- 真正有效的快捷方式只有两个：
Coverage Gutters: Refresh（Ctrl+Shift+P 输入执行），或配置tasks.json让测试命令结束后自动触发该命令 - 别依赖 “Testing” 视图右上角的播放按钮：它调用的是 VS Code 内置测试 API，和覆盖率插件无绑定关系
- Go 用户注意：
Go: Toggle Test Coverage是 vscode-go 自带命令，必须手动触发，且只在coverage.out存在后才生效；它不响应任何自动测试事件
最常被忽略的一点：lcov.info 里的 SF: 路径必须和你在 VSCode 中打开的文件绝对路径完全一致。WSL、Docker、monorepo 符号链接、跨平台构建都可能导致路径前缀错位——此时即使文件存在、插件启用、命令跑通，行号也不会染色。
