Jest/Istanbul覆盖率忽略提示失效，求排查配置问题

我太懂这种明明按文档加了忽略注释，覆盖率却纹丝不动的憋屈感了！结合你用TypeScript+ts-jest的配置，大概率是ts-jest的预处理环节把注释吃掉了，或者工具链的兼容性问题，咱们一步步解决：

1. 调整ts-jest配置，确保保留注释并兼容Istanbul #

旧版本的ts-jest默认会移除注释，导致Istanbul根本看不到你的/* istanbul ignore */提示。你需要在jest配置里给ts-jest加上babel插件配置，强制保留注释并启用Istanbul支持：

修改你的jest配置里的transform部分：

"jest": {
  "transform": {
    "^.+\\.(ts|tsx)$": [
      "ts-jest",
      {
        "tsconfig": "tsconfig.json",
        "babelConfig": {
          "plugins": ["istanbul"]
        }
      }
    ]
  },
  // 其他原有配置保持不变...
}

别忘了先安装依赖：

npm install --save-dev babel-plugin-istanbul

2. 排查source map的干扰 #

你配置里的mapCoverage: true可能会导致覆盖率映射错位——Istanbul根据source map找代码位置时，注释的位置可能被映射错了。试试临时把mapCoverage改成false，再跑一遍覆盖率看看有没有效果。

3. 确认注释格式完全正确 #

虽然你写的注释看起来没问题，但要注意两个细节：

• 注释必须紧挨着要忽略的代码，中间不能有空行或者多余的空格
• 单行忽略用/* istanbul ignore next */时，必须放在要忽略的那一行的上一行

比如正确的单行用法：

/* istanbul ignore next */
console.log(`RouterStore.transition(${fromStateStr}, ${toStateStr})`);

4. 升级工具链到兼容版本 #

如果上面的方法都没用，可能是Jest、ts-jest、Istanbul之间版本不兼容。建议升级到当前稳定的兼容版本：

• 优先选择 Jest 29.x + ts-jest 29.x 的组合（目前主流稳定搭配）
• 确保所有依赖版本匹配，避免跨版本冲突

最后验证 #

修改完配置后，先删除之前的覆盖率缓存（一般是项目根目录的coverage文件夹），然后重新运行测试命令，看看忽略的代码是不是已经被排除在覆盖率统计外了。

内容的提问来源于stack exchange，提问作者Naresh