函数覆盖率衡量被测试用例实际调用过的函数比例，计算公式为（被调用函数数÷总函数数）×100%，Istanbul通过AST识别各类函数，需插桩代码并配置collectCoverage:true，未覆盖常见因未调用或动态定义导致。
函数覆盖率（Function Coverage）衡量的是项目中被测试用例**实际调用过的函数比例**，是代码质量评估的关键指标之一。它不关心函数内部逻辑是否跑全，只关注“这个函数有没有被调用过”。只要函数体被执行一次，就算该函数已覆盖。
函数覆盖率怎么算？
计算公式很简单：
函数覆盖率 = （被调用过的函数数量 ÷ 项目中所有可识别的函数总数）× 100%
这里的“函数”包括：函数声明、函数表达式、箭头函数（若被单独赋值给变量）、类方法（静态/实例）、getter/setter 等。Istanbul 会通过 AST 静态分析准确识别这些节点，不会漏掉匿名或动态定义的函数。
立即学习“Java免费学习笔记（深入）”；
如何用 Istanbul / nyc 获取函数覆盖率
主流工具默认开启函数覆盖率统计，无需额外配置，但需确保：
- 测试运行时加载的是经过插桩（instrumented）的代码，而非原始源码
- 测试框架（如 Jest、Vitest、Mocha）与 Istanbul 正确集成（例如 Jest 默认使用 @jest/transform + istanbul-instrumenter）
- 在配置中显式启用（推荐）：
collectCoverage: true和coverageReporters: ['html', 'text']
执行测试后，终端输出或 HTML 报告中会明确显示类似：
Functions: 87.5% (7/8) —— 表示共识别出 8 个函数，其中 7 个被至少调用一次。
为什么某个函数没被覆盖？常见原因
函数未被计入覆盖率，通常不是工具问题，而是测试设计或代码结构导致：
- 函数定义了但从未被任何测试用例（或其调用链）触发
- 函数仅在条件分支中定义（如
if (false) function foo() {}），AST 可能跳过识别 - 函数被包裹在立即执行函数（IIFE）或模块顶层作用域外，且未导出/未被引用
- 使用了动态函数创建方式（如
new Function(...)），Istanbul 无法静态识别 - 测试未覆盖到调用该函数的路径（比如只测了 if 分支，漏了 else 中的函数调用）
如何提升函数覆盖率
目标不是“凑满100%”，而是确保关键行为函数都被验证：
- 检查 HTML 报告中红色高亮的函数名，定位未覆盖函数所在文件和行号
- 对导出的公共函数逐个编写最小调用测试（哪怕只传默认参数）
- 留意错误处理路径中的函数（如 catch 块里的日志上报函数）
- 避免“死代码”：确认未覆盖函数是否已废弃，若是，直接删除更安全
- 对 React 组件中的事件处理器、useEffect 回调等，补充用户交互模拟测试
函数覆盖率本身不能保证逻辑正确，但它是一道有效的“兜底防线”——帮你快速发现那些完全没人碰过的函数入口。
