JavaScript代码覆盖率通过插桩工具注入探针记录执行情况，主流方案有nyc、Jest内置支持、Vitest+c8；关键指标包括行、分支、函数、语句覆盖率；本地可实时验证；Monorepo需统一lcov格式后合并生成总报告。
JavaScript 项目中代码覆盖率主要通过插桩（instrumentation）工具在测试执行时注入探针，自动记录哪些语句、分支、函数或行被实际运行过，再汇总生成量化报告。主流方案成熟稳定，无需从零实现。
常用工具与基础用法
目前最主流的三类工具覆盖绝大多数场景：
-
nyc（istanbul）：独立覆盖率工具，兼容任意测试框架。安装后加一行配置即可使用：
npm install --save-dev nyc，然后运行nyc npm test，自动生成coverage/目录和 HTML 报告，清晰展示 Lines / Branches / Functions / Statements 四类指标。 -
Jest 内置支持：开箱即用，只需添加
--coverage参数，例如npx jest --coverage。默认输出终端表格，也可配置coverageReporters: ['html', 'lcov']生成可视化报告和标准中间格式。 -
Vitest + c8：Vite 生态推荐组合。
c8轻量高效，支持终端实时显示和 HTML 报告双模式，命令简洁：vitest run --coverage --coverage.reporter=html。
关键指标怎么看
报告中四个核心维度反映不同质量侧面：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 行覆盖率（Lines）：统计源码中哪些物理行被执行过，直观但粒度较粗；一行含多个逻辑仍只算一次。
-
分支覆盖率（Branches）：检查每个
if、switch、三元表达式等真假路径是否都走通，更能暴露测试数据单一的问题。 - 函数覆盖率（Functions）：确认导出或内部函数是否至少被调用一次，为零通常意味着死代码或遗漏主流程。
-
语句覆盖率（Statements）：比行更细，将复合语句拆解为原子操作，比如
return a && b;会被视为两个可执行语句。
本地开发中快速验证
不用等 CI 或完整测试套件跑完，也能即时看到效果：
立即学习“Java免费学习笔记（深入）”；
- Vite 项目装
vite-plugin-istanbul，启动 dev server 后访问http://localhost:5173/__coverage__，打开即见实时面板。 - Chrome DevTools 打开 Coverage 面板（More Tools → Coverage），刷新页面就能看到 JS 文件中已执行（蓝色）和未执行（红色）的字节占比，适合首屏加载分析。
- 在控制台输入
window.__coverage__，直接查看当前收集到的原始覆盖率对象，验证插桩是否生效、路径是否匹配。
多包项目统一统计
Monorepo 场景下，各子包需对齐格式再合并：
- 所有包统一输出
lcov.info（Jest 设coverageReporters: ['lcov']，Vitest 用--coverage.reporter=lcov）。 - 把各包生成的
lcov.info集中复制到根目录coverage/lcov/并重命名（如a.lcov、b.lcov）。 - 用
lcov命令合并过滤：lcov --directory coverage/lcov --output-file total.info，再排除node_modules等无关路径，最后genhtml生成总报告。
