深度定制插桩规则主要通过 nyc + babel-plugin-istanbul 实现，包括 .nycrc 范围控制、babel 插件选项调优及自定义 instrumenter 类；c8 仅支持路径过滤等有限裁剪。
要深度定制 Istanbul 或 c8 的插桩规则，核心在于控制“代码注入”（instrumentation）行为——即决定哪些代码被插计数器、如何插、插什么、哪些跳过。这不是简单开关配置，而是对源码 AST 的精细干预。
明确插桩入口：选对工具链与时机
Istanbul（现主流为 nyc）和 c8 虽目标一致，但底层机制不同：
-
nyc 基于 Babel 插件（
babel-plugin-istanbul），在转译阶段插桩。适合需兼容旧语法、需自定义 AST 处理逻辑的场景。 -
c8 基于 V8 的
--inspect-brk和 Coverage API，运行时采集，不修改源码。插桩由 V8 引擎自动完成，用户只能通过配置过滤路径或调整采样粒度，无法直接改插桩逻辑。
因此，“深度定制插桩规则”主要指 nyc + babel-plugin-istanbul 方案；c8 仅支持有限裁剪（如忽略文件、设置返回值覆盖等）。
用 .nycrc 配置插桩范围与粒度
通过 .nycrc 或 nyc.config.js 控制插桩边界，这是最常用也最关键的定制层：
-
include/exclude：精确指定参与插桩的文件 glob 模式，比如只插src/**/*.{js,ts}，排除**/*.test.js和类型声明。 -
all: true：强制对include范围内所有文件插桩（即使未被测试导入），避免漏掉未引用的工具模块。 -
extension：支持扩展插桩语言，例如添加[".ts", ".tsx"]并确保已配好 TypeScript 转译器。 -
require：提前加载辅助模块，如ts-node/register，让插桩前先完成类型擦除。
自定义 babel-plugin-istanbul 插件选项
在 babel.config.js 中显式配置插件，可启用高级行为：
-
exclude（插件级）：比 nyc 级更细粒度，例如跳过某个高复杂度函数体：exclude: ["./src/utils/legacyHelper.js"]。 -
ignoreClassMethods：设为["constructor", "render"]可跳过 React 组件中特定方法的分支/语句计数，避免干扰真实业务逻辑覆盖率。 -
produceSourceMap：设为true生成带原始位置映射的覆盖率数据，便于调试未覆盖行对应的真实源码位置。 -
compact: false：保留插桩后代码换行与缩进，方便人工检查注入逻辑是否合理（调试阶段推荐）。
编写自定义 instrumenter（进阶）
若需彻底控制插桩逻辑（例如：只为 if 后的块插分支计数，跳过 else；或对特定注释标记的语句禁用计数），需继承 istanbul-lib-instrument 的 Instrumenter 类：
- 重写
instrumentSync(code, filename, opts)方法，在 AST 遍历中识别自定义节点（如带/* istanbul ignore next */的注释或特定 JSDoc 标签）。 - 调用
this.visitor注入定制计数器，或调用this.skip()跳过某节点插桩。 - 将自定义 instrumenter 传给 nyc 的
require配置项，替代默认实现。
注意：此方式需熟悉 Babylon / @babel/parser AST 结构，且每次 Istanbul 升级可能影响兼容性，建议仅用于强定制需求。
不复杂但容易忽略：插桩定制效果必须配合 nyc check-coverage 或 CI 中的阈值校验才能落地，否则只是生成了“看起来不同”的报告而已。
