Coverage Gutters 插件显示空白是因为未生成 lcov.info 文件、路径不匹配或格式不支持；它仅读取报告，不运行测试也不转换格式，需手动验证文件存在性、配置 collectCoverage:true 及正确路径映射。

装了插件却没颜色？大概率是 lcov.info 没生成、路径对不上，或者格式不被 Coverage Gutters 认——它只读，不跑测试，也不转换格式。

为什么 Coverage Gutters 在 Node.js 项目里显示空白

Coverage Gutters 不会调 jest 或 vitest，它只扫描你指定路径下的报告文件。常见失败链：

• npx jest --coverage 没执行，或 package.json 里 "test:coverage" 脚本漏了 --coverage
• jest.config.js 中没设 collectCoverage: true，或 coverageReporters 没包含 'lcov'
• Vitest 默认输出 coverage/vitest-coverage.json，而 Coverage Gutters 默认不认这个——得改配置：coverage: { reporter: ['lcov'] }
• 手动检查 coverage/lcov.info 是否真实存在：终端进项目根目录，ls coverage/lcov.info；不存在就说明测试根本没生成覆盖率数据

怎么让 Jest 正确生成 lcov.info

关键不是“跑测试”，而是“带覆盖率参数跑”。Jest 默认关掉覆盖率收集，必须显式启用：

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

• 确保 jest.config.js 包含：

  module.exports = {
    collectCoverage: true,
    coverageDirectory: 'coverage',
    coverageReporters: ['lcov', 'text'],
    collectCoverageFrom: [
      'src/**/*.{js,ts}',
      '!src/**/*.d.ts',
      '!src/**/index.ts'
    ]
  };

• 或直接命令行验证：npx jest --collectCoverage --coverageReporters=lcov，看是否生成 coverage/lcov.info
• 注意 collectCoverageFrom 路径写错会导致部分文件被跳过——比如写成 src/*.ts 就不会匹配子目录，得用 src/**/*.{js,ts}
• 如果用了 TypeScript，确保 tsconfig.json 中 outDir 和 rootDir 不干扰源码路径映射；Coverage Gutters 对的是 .ts 原始路径，不是编译后的 .js

VSCode 里路径匹配失败的典型表现和修复

状态栏显示 “Coverage: 72%”，但 gutter 区全白？这是路径不一致的铁证。Coverage Gutters 靠比对 lcov.info 里的 SF: 行（source file）和 VSCode 当前打开文件的绝对路径做映射：

• 打开 coverage/lcov.info，搜索你正在编辑的文件名，看 SF: 后面写的路径是不是和编辑器左下角显示的路径完全一致（包括大小写、./、斜杠方向）
• Monorepo 或 pnpm 项目中，SF: 可能指向符号链接的真实路径（如 /home/user/repo/packages/foo/src/index.ts），而 VSCode 打开的是 workspace 相对路径（packages/foo/src/index.ts）→ 这时需用 sed -i 's|/home/user/repo/||g' coverage/lcov.info 临时修正
• Windows + WSL 混用时，SF: 是 /mnt/c/...，VSCode 打开的是 C:... → 必须统一为一种风格，推荐在 WSL 内全用 Linux 路径并用 VSCode Remote - WSL 打开
• 检查 VSCode 设置里 coverage-gutters.coverageFileNames 是否仍为默认值；有人手删过 lcov.info 导致插件找不到文件

保存代码后如何自动刷新覆盖率标记

右键菜单“运行测试”不会触发 Coverage Gutters 刷新。必须靠任务绑定：

• 在 .vscode/tasks.json 中定义一个后台任务：

  {
    "version": "2.0.0",
    "tasks": [{
      "label": "test:coverage",
      "type": "shell",
      "command": "npx jest --coverage",
      "isBackground": true,
      "problemMatcher": []
    }]
  }

• 再配个文件监听：在 .vscode/settings.json 加上：

  "emeraldwalk.runonsave": {
    "commands": [{
      "match": "\.ts$",
      "cmd": "npm run test:coverage"
    }]
  }

  （需装 Run On Save 插件）
• 或者更轻量：用快捷键 Ctrl+Shift+P → 输入 Coverage Gutters: Reload 手动刷新，比等自动更可控

最常被忽略的点：Coverage Gutters 从不校验报告内容是否合理——哪怕 lcov.info 是空文件、路径全错、或只有 1 行数据，它都默默加载、不报错、只留一片空白。验证第一步永远是终端里 cat coverage/lcov.info | head -n 5，确认有真实的 SF: 和 DA: 行。