vscode不生成、不运行测试，coverage gutters仅读取并渲染lcov.info或coverage.xml等已有报告文件，需测试框架显式生成、路径严格匹配、参数正确配置且手动刷新。
VSCode 没有一键生成完整测试覆盖方案的插件——所谓“一键”，只是把已有工具链串起来，而漏掉任意一环（比如报告格式、路径、参数写法），覆盖率就根本不会显示。
coverage-gutters 不是测试生成器，只读文件不跑测试
Coverage Gutters 插件本身不做任何测试执行或代码分析，它只做一件事：在编辑器里染色。前提是项目根目录下存在它认得的 lcov.info 或 coverage.xml 文件，并且里面记录的源码路径能和你在 VSCode 里打开的文件路径完全对上。
- 它不调用
jest、pytest或dotnet test，也不会帮你写测试用例 - 你右键点击“Run Test”或点测试侧边栏的 ▶️，Coverage Gutters 完全无感——必须手动按
Ctrl+Shift+P→ 输入Coverage Gutters: Refresh - 如果报告文件是
coverage/vitest-coverage.json或.coverage（pytest 默认二进制格式），它直接无视
Python 用户最常卡在 pytestArgs 写成字符串
VSCode 的 python.testing.pytestArgs 配置项要求是数组，不是字符串。写成 "--cov=src --cov-report=xml:coverage.xml" 就会触发 unrecognized arguments 错误，因为整个字符串被当成了一个参数传给 pytest。
- 正确写法必须是数组：
"python.testing.pytestArgs": ["--cov=src", "--cov-report=xml:coverage.xml"] - 加
--cov-report=term-missing能立刻看到未覆盖行，比等插件染色快得多 - 确保
coverage.xml真的存在且非空：运行后执行head -n 3 coverage.xml，应看到<?xml开头 - 检查
<source></source>路径是否匹配：如果 XML 里是/home/user/project/src/utils.py，但你在 VSCode 打开的是./src/utils.py，染色就失效
Jest 和 Vitest 的 lcov 输出路径必须显式指定
Jest 默认生成 coverage/lcov.info，Coverage Gutters 能自动识别；但 Vitest 默认输出的是 coverage/vitest-coverage.json，它不支持。
- Vitest 必须加参数：
vitest --coverage reporter=lcov，否则插件找不到可读文件 - Jest 若改过
coverageDirectory（如设为"coverage-out"），就得在 VSCode 设置里改"coverage-gutters.coverageFileNames"为["coverage-out/lcov.info"] - 别依赖
collectCoverage: true配置：如果 jest.config.js 里写了collectCoverage: false，哪怕加了--coverage参数也白搭
Q# 和 Go 的覆盖率容易空文件，关键在插桩范围
Q# 用 dotnet test + coverlet.collector，Go 用 go test，都容易生成空的覆盖率文件——不是工具坏了，是没告诉它们“该测哪些包”。
- Q# 项目必须在 .csproj 中显式引用
<packagereference include="coverlet.collector" version="3.2.0"></packagereference>，否则--collect:"Xplat Code Coverage"不生效 - Go 必须加
-coverpkg=./...（注意三个点），否则coverage.out只含测试文件自身，业务代码一行不插桩 - Q# 的
coverage.json或 Go 的coverage.out都不能直接被 Coverage Gutters 读取，需用reportgenerator或go tool cover转成lcov.info或coverage.xml
真正卡住人的从来不是“怎么装插件”，而是报告文件存在却染不上色——那八成是路径映射错位、参数拼错、格式不支持，或者你以为它会自动刷新，其实它连文件改动都不监听。
