代码覆盖率是衡量测试用例执行源代码比例的指标，主流工具为Istanbul（nyc），Jest/Vitest内置支持，Mocha需手动集成；报告含Lines、Functions、Branches、Statements四维度；提升覆盖率需覆盖所有分支、异步逻辑、异常路径及React状态更新。
代码覆盖率是指测试用例执行时，源代码中被运行到的行、分支、函数或语句所占的比例。它不是质量保证的终点，但能帮你快速发现哪些逻辑路径没被测到——比如一个 if 分支永远没进过，或者某个工具函数压根没调用。
JavaScript 中常用的覆盖率工具
目前最主流的是 Istanbul（及其命令行工具 nyc），它是 Babel、Jest、Vitest 等测试框架默认集成的覆盖率引擎。Vitest 和 Jest 内置了 Istanbul，开箱即用；如果你用原生 Mocha 或自定义测试流程，可以单独装 nyc。
- Jest：在 jest.config.js 里设
collectCoverage: true，再加coverageDirectory和coverageProvider: 'v8'（推荐，更快更准） - Vitest：默认不开启，加
coverage: { enabled: true }即可，底层用 c8（V8 引擎原生覆盖），比 Istanbul 更轻量 - 纯 Node 脚本 + Mocha：用
nyc mocha test/*.js启动，会自动注入和报告
看懂覆盖率报告的关键指标
一份标准报告包含四类基础维度：
- Lines：有多少行代码被执行过（注意：空行、注释、只含花括号的行不计入）
- Functions：定义的函数里，有几个至少被调用了一次
- Branches：if/else、三元、逻辑与或等分支结构中，有多少分支路径被执行
- Statements：可执行语句（如赋值、return、throw）的执行比例，通常和 Lines 接近但不等价
例如：return a > 0 ? 'yes' : 'no' 算 1 个语句、1 个函数、2 个分支——只测 a > 0 为真，分支覆盖率就只有 50%。
立即学习“Java免费学习笔记（深入）”；
怎么写测试才能真正提升覆盖率？
别为了数字凑 coverage，重点是让测试暴露逻辑盲区：
- 每个 if / else / switch case 都要覆盖，包括边界条件（如
arr.length === 0） - 异步代码记得 await 或 return Promise，否则覆盖率统计会漏掉后续行
- try/catch 的 catch 块容易被忽略，可手动抛错或用 sinon.stub 模拟异常
- React 组件测试中，触发事件（如 fireEvent.click）后要等状态更新（act + waitFor），否则渲染相关行可能标红
基本上就这些。覆盖率本身不难跑，难的是理解它提示的问题——哪段逻辑脆弱、哪条路径危险、哪个参数组合没试过。把它当一面镜子，而不是 KPI。
