Istanbul（nyc）是JavaScript代码覆盖率工具，通过静态分析和插桩测量语句、函数、分支和行的执行情况；支持多种报告格式，可配置阈值用于CI，结合Mocha等框架生成HTML报告，绿色为已覆盖、红色为未执行、黄色为部分覆盖，帮助定位测试盲区，提升代码质量。
在编写单元测试或集成测试时，了解测试的覆盖程度至关重要。代码覆盖率帮助开发者判断哪些代码被执行过，哪些未被触及，从而提升测试质量。Istanbul 是 JavaScript 生态中广泛使用的代码覆盖率工具，能够生成直观的报告，衡量测试的完整性。
什么是 Istanbul？
Istanbul（也称为 nyc）是 Node.js 和浏览器环境中用于测量 JavaScript 代码覆盖率的工具。它通过静态分析和运行时插桩，在测试执行过程中记录每行代码、每个分支、函数和语句的执行情况，最终生成详细的覆盖率报告。
支持多种指标：
- 语句覆盖率（Statements）：哪些语句被执行过
- 函数覆盖率（Functions）：哪些函数被调用过
- 分支覆盖率（Branches）：if/else、三元运算等逻辑分支是否都经过测试
- 行覆盖率（Lines）：源码中每一行是否被执行
如何使用 nyc 测量覆盖率
以 Node.js 项目为例，使用 nyc 结合 Mocha 或 Jest 进行测试和覆盖率统计非常方便。
1. 安装依赖安装 nyc 和测试框架（如 Mocha）：
npm install --save-dev nyc mocha2. 配置 scripts
在 package.json 中添加命令：
"scripts": {
"test": "mocha",
"coverage": "nyc npm test"
}
3. 运行覆盖率检查
执行以下命令：
npm run coverage
nyc 会自动插桩代码，运行测试，并输出控制台覆盖率摘要，同时生成 coverage/ 目录存放详细 HTML 报告。
配置 Istanbul（nyc）行为
可在 .nycrc 或 package.json 中配置选项，例如：
{
"include": [
"src/**/*.js"
],
"exclude": [
"**/*.test.js",
"node_modules"
],
"reporter": ["text", "html", "lcov"],
"check-coverage": true,
"lines": 90,
"statements": 90,
"functions": 90,
"branches": 80
}
说明：
- reporter：指定输出格式，html 可生成可视化页面
- check-coverage：启用阈值检查，若未达标则构建失败
- 数字代表最低覆盖率要求，适合 CI 环境中强制保障测试质量
查看覆盖率报告
运行完成后，打开 coverage/index.html 文件，用浏览器查看详细报告。可点击文件名逐层查看：
- 绿色表示已覆盖
- 红色表示未执行代码
- 黄色表示部分分支未覆盖（如 if 成立但 else 未走）
这有助于快速定位测试盲区，补充缺失用例。
基本上就这些。Istanbul（nyc）配合主流测试框架，能有效提升测试透明度和代码质量，是现代 JavaScript 开发中不可或缺的一环。
