istanbul（现由istanbuljs维护）是javascript最常用的代码覆盖率工具，支持行、语句、分支和函数覆盖统计，需与jest/mocha/vitest等测试运行器集成；常用工具链包括nyc、jest内置支持、vitest开箱支持或c8；配置nyc后可生成text/html/lcov报告，并支持ci中按阈值校验防止覆盖率下滑。
在 JavaScript 项目中，Istanbul（现主要由 istanbuljs 组织维护）是最常用的代码覆盖率工具，它能帮你量化测试对源码的覆盖程度，比如行、语句、分支和函数是否被测试执行过。要统计测试率，核心是让测试运行器（如 Jest、Mocha、Vitest 等）与 Istanbul 集成，并生成可读的覆盖率报告。
确认 Istanbul 工具链已安装
Istanbul 不再以单个 istanbul 包发布，而是拆分为多个模块。常用组合包括：
-
nyc（istanbul-lib-coverage+istanbul-lib-instrument+ CLI）——最通用的命令行入口，支持 Mocha、AVA、Tap 等； - Jest 内置 Istanbul（通过
jest --coverage），无需额外安装； - Vitest 默认使用
istanbul（v1.0+），开箱支持覆盖率； - 若用原生 Node.js 测试，可搭配
c8（Chromium V8 的覆盖率封装，更轻快，但非 Istanbul 实现）。
以 nyc 为例，安装命令为：
npm install --save-dev nyc
配置 nyc 并运行测试
在项目根目录添加 nyc.config.js 或 .nycrc 文件，指定目标文件、忽略路径和报告格式：
// nyc.config.js
module.exports = {
include: ['src/**/*.js'],
exclude: ['src/**/__tests__/**', 'src/**/index.js'],
reporter: ['text', 'html', 'lcov'],
all: true // 强制包含未执行文件（显示 0% 行）
};
然后修改 package.json 中的测试脚本：
"scripts": {
"test": "nyc mocha src/**/__tests__/*.test.js"
}
执行 npm test 后，终端会输出文本覆盖率摘要，同时生成 coverage/ 目录（含 HTML 报告）。
解读关键覆盖率指标
Istanbul 默认报告 4 类覆盖率：
- Statements：语句覆盖率（是否每条可执行语句都被执行）；
- Branches：分支覆盖率（if/else、三元、逻辑运算符等所有分支路径是否都走了一遍）；
- Functions：函数覆盖率（是否每个声明的函数都被调用）；
- Lines：行覆盖率（与 Statements 基本一致，因 JS 中换行不等于新语句）。
例如某文件报告显示：Statements 85%, Branches 60%, Functions 90%, Lines 85%，说明分支覆盖最弱，应重点补全 if 分支、循环边界、异常路径等测试用例。
与 CI/CD 集成并设置阈值
防止覆盖率下滑，可在 CI 中强制校验最低阈值。例如在 nyc.config.js 中添加：
module.exports = {
// ... 其他配置
checkCoverage: true,
perFile: true,
thresholds: {
lines: 80,
statements: 80,
functions: 85,
branches: 70
}
};
当任一文件或整体低于阈值时，nyc 将退出非零状态，CI 构建失败，提醒开发者补充测试。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
