VSCode插件更新后覆盖率统计异常是因Coverage Gutters等插件行为变更导致路径解析、文件监听或格式兼容性断裂；新版默认只认lcov.info、校验更严，需检查文件存在性、路径一致性、手动刷新、配置重载及多根工作区独立设置。
VSCode 插件更新后覆盖率统计异常，基本可以确定是 Coverage Gutters 或关联插件（如 vscode-jest、Python Test Explorer）行为变更导致的路径解析、文件监听或格式兼容性断裂——不是你代码或配置突然坏了，而是插件新版对旧约定更严格了。
为什么更新后 lcov.info 突然“看不见”了？
新版 Coverage Gutters（v2.10+）默认不再 fallback 尝试读取 coverage/coverage-final.json，只认 lcov.info；同时加强了路径匹配校验，对空格、大小写、斜杠方向（/ vs \）、前导 ./ 更敏感。
- 检查 VSCode 输出面板 →
Coverage Gutters日志，是否出现File not found: coverage/lcov.info或Invalid lcov format at line X - 运行
ls -l coverage/lcov.info（Linux/macOS）或dir coverage\lcov.info（Windows），确认文件存在且非空 - 打开
lcov.info，搜索SF:行，看路径是否和你在 VSCode 中打开的文件路径完全一致（例如：SF:src/utils.tsvs 你打开的是./src/utils.ts）
vscode-jest 更新后覆盖率数字不刷新
新版 vscode-jest（v4.1+）默认禁用自动触发覆盖率报告生成，仅响应 Jest: Start Runner 命令，不再监听 npm test 或终端命令执行结果。
- 必须手动执行一次
Coverage Gutters: Refresh（Ctrl+Shift+P 输入执行），或绑定到测试任务 - 在
.vscode/tasks.json中确保测试任务含"group": "build"和正确problemMatcher，否则插件无法感知完成信号 - 如果用了 Jest 的
--watch模式，注意它默认不重写lcov.info—— 改用npx jest --coverage --watchAll --coverageReporters=lcov强制覆盖
Python 用户：coverage.xml 路径和内容被新版本拒绝
新版 Coverage Gutters 对 coverage.xml 的 <source> 节点校验更严，若路径含 /home/user/project/ 而你工作区是 file:///c:/project/（WSL/Windows 混合环境），会直接跳过染色。
- 不要依赖
pytest --cov=. --cov-report=xml，必须指定输出路径：--cov-report=xml:coverage.xml - 在
pyproject.toml中加[tool.coverage.run] relative_files = true，让<source>写成src/utils.py而非绝对路径 - 如果已生成带绝对路径的
coverage.xml，可用sed -i 's|/mnt/c/|C:/|g' coverage.xml（WSL）或 PowerShell 替换修复
自动刷新失效：autoRefresh 不再“智能猜测”
"coverage-gutters.autoRefresh": true 在 v2.12+ 后改为只监听文件系统事件，不再轮询或响应测试完成信号——这意味着如果 lcov.info 是被 jest --watch 增量更新（而非全量重写），插件可能错过变更。
- 改用
onchange或nodemon监听src/**/*.{js,ts}和tests/**/*，执行完整命令：npx jest --coverage --coverageReporters=lcov - 确保
lcov.info时间戳确实更新（stat coverage/lcov.info），否则插件不会触发重载 - 多根工作区下，每个文件夹的
.vscode/settings.json必须单独配coverage-gutters.lcovname，父级设置不再继承
最常被忽略的一点：插件更新后，VSCode 不会自动重载旧配置缓存。哪怕你改了 settings.json，也得重启窗口（Developer: Reload Window）才能让新规则生效——否则所有调试都白做。
