VSCode本身不运行测试、不生成覆盖率报告，只读取并渲染外部工具生成的标准报告文件（如lcov.info或coverage.xml）；必须显式执行带覆盖率参数的测试命令（如jest --coverage、pytest --cov=. --cov-report=xml）、确保路径与格式严格匹配插件预期，并手动刷新或配置任务触发显示。
VSCode 本身不运行测试、不生成覆盖率报告，只负责读取和渲染——你必须先用对应语言的测试工具（jest、pytest、go test 等）显式生成标准格式报告（如 lcov.info 或 coverage.xml），再由插件（如 Coverage Gutters 或 vscode-go）加载显示。
确认测试命令能真实生成报告文件
别假设“跑完测试就自动有覆盖率”，所有语言都需显式加参数：
-
jest --coverage会默认生成coverage/lcov.info，但若配置了collectCoverage: false或没设coverageDirectory，文件可能根本不会出现 -
pytest --cov=. --cov-report=xml:coverage.xml是必须写的；只写--cov=.会生成二进制.coverage，Coverage Gutters完全无视 -
go test -coverprofile=coverage.out -covermode=count -coverpkg=./ ./缺少-coverpkg时，coverage.out常为空或仅含测试文件自身，业务代码没被插桩
路径和格式必须严格匹配插件预期
Coverage Gutters 不猜路径、不自动修复格式，它只按配置去读：
- 默认找
lcov.info，但如果你生成的是coverage/coverage.lcov，就得在settings.json里改"coverage-gutters.coverageFileNames": ["coverage/coverage.lcov"] - Python 用户常把
coverage.xml放错位置：它必须在项目根目录（即workspaceFolder），不能在src/或tests/下；否则插件解析时找不到对应源码路径 - Vitest 默认输出
coverage/vitest-coverage.json，而Coverage Gutters不支持该格式，得加参数vitest --coverage reporter=lcov或换用Wallaby.js
刷新不是自动的，得手动触发或配任务
VSCode 测试面板右上角的 ▶ 按钮、右键菜单里的 “Run Test”，都不会通知覆盖率插件更新——它们只执行测试命令，不发 reload 信号：
- 最可靠方式是：测试跑完后，按
Ctrl+Shift+P→ 输入Coverage Gutters: Refresh手动刷新 - 想省事？在
.vscode/tasks.json里定义一个 task，命令为pytest --cov=. --cov-report=xml:coverage.xml，并勾选"problemMatcher": []避免误报错误 - Go 用户注意：
Go: Toggle Test Coverage是 vscode-go 自带命令，必须手动触发，且只在coverage.out存在后才生效；它不响应任何自动测试事件
最容易被忽略的是路径映射：coverage 文件里记录的是绝对路径（比如 /home/user/project/src/main.py），而你在 VSCode 里打开的是相对路径 ./src/main.py，或者用了 WSL/Docker 导致路径前缀不一致——染色失败往往就卡在这一步，不是插件坏了，是路径对不上。
