JavaScript测试覆盖率失真主因是Babel/TS等工具生成的辅助代码被计入，应通过jest的collectCoverageFrom白名单、coveragePathIgnorePatterns黑名单、禁用tslib内联、istanbul注释及修复source map映射来精准过滤。
在 JavaScript 项目中生成测试覆盖率报告时，常会把 Babel、TypeScript 编译器、Webpack 或 Jest 自身注入的辅助代码（如 __awaiter、__generator、regeneratorRuntime、Babel runtime helpers）也计入覆盖率，导致数据失真。要排除这些工具生成的代码，核心是让测试覆盖率工具（如 jest + istanbul）在收集和报告阶段跳过它们。
配置 Jest 的 collectCoverageFrom + coveragePathIgnorePatterns
这是最常用且直接的方式。Jest 默认使用 Istanbul（via babel-jest 或 ts-jest）收集覆盖率，通过以下两个配置协同过滤：
-
collectCoverageFrom：显式声明哪些源码文件参与覆盖率统计（白名单思维） -
coveragePathIgnorePatterns：在已匹配的文件中，进一步忽略特定路径或文件名模式（黑名单补充）
示例 jest.config.js：
module.exports = {
collectCoverageFrom: [
'src/**/*.{js,jsx,ts,tsx}',
'!src/**/*.d.ts',
'!src/**/index.{js,ts}', // 可选：忽略入口聚合文件
],
coveragePathIgnorePatterns: [
'/node_modules/',
'/dist/',
'/lib/',
'/coverage/',
'.*\.test\.(js|ts)x?$',
'.*\.spec\.(js|ts)x?$',
'globalSetup\.js$',
'globalTeardown\.js$',
// 忽略 Babel/TS 工具生成的辅助代码（通常出现在编译后输出或内联）
'babel-runtime',
'regenerator-runtime',
'@babel/runtime',
'tslib',
],
};
</font><H3>在 TypeScript 项目中禁用 tslib 内联辅助代码</H3><p>TypeScript 默认开启 <code>importHelpers: true</code> 并依赖 <code>tslib</code>，其 helper 函数（如 <code>__extends</code>、<code>__decorate</code>）会被插入到每个编译后的文件里。虽然它们属于“工具生成”，但因混在源文件编译结果中，<code>coveragePathIgnorePatterns</code> 无法精准剔除单个函数。</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/c1c2c2ed740f" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Java免费学习笔记（深入）</a></a>”；</p><p>解决方法：</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill6235" title="Java Maven Code Review"><img
src="https://img.php.cn/upload/skill/000/000/081/179084711841712.jpg" alt="Java Maven Code Review" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill6235" title="Java Maven Code Review">Java Maven Code Review</a>
<p>审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。</p>
</div>
<a href="/xiazai/skill6235" title="Java Maven Code Review" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><ul><li>在 <code>tsconfig.json</code> 中设 <code>"importHelpers": false</code>（不推荐：增大包体积）</li><li>更推荐：保持 <code>importHelpers: true</code>，但将 <code>tslib</code> 声明为 external（如用 Webpack 打包时），或确保测试运行的是原始 TS 源码（而非编译后 JS）——即用 <code>ts-jest</code> 直接转译，此时 Istanbul 可基于源码映射（source map）准确归因，而 <code>tslib</code> 的 helper 本身不被纳入 <code>collectCoverageFrom</code> 路径，自然不参与统计</li></ul><H3>使用 istanbul ignore 注释（细粒度控制）</H3><p>对个别无法通过路径过滤的工具代码（比如某段手动引入的 polyfill 或动态注入的 runtime），可在代码中添加注释标记，让 Istanbul 跳过该区域：</p><font color="#888"><pre class="brush:php;toolbar:false;">
// istanbul ignore next
if (typeof window !== 'undefined') {
window.myPolyfill = createPolyfill();
}
支持的注释形式包括：
-
// istanbul ignore next（忽略下一行） -
// istanbul ignore if（忽略整个 if 块） -
// istanbul ignore file（忽略整个文件，放在文件顶部）
注意：需确保测试配置中未禁用 reporters 的 text-summary 或 html，且 Istanbul 版本支持（v1.0+ 均支持）。
检查 source map 是否正确映射源码
如果用了 Babel 或 TS 编译，但覆盖率仍显示大量 __* 函数被覆盖，很可能是 Istanbul 没能正确映射回原始源码，导致它把编译产物当作了“源文件”。请确认：
- Babel 配置中
sourceMaps: true（或inlineSources: true）已启用 - Jest 配置中
transformSourceCode或ts-jest的isolatedModules: false（推荐）以保留完整 source map - 运行
jest --coverage --coverageReporters=text查看是否提示 “Some files are missing from the coverage report due to missing source maps”
修复 source map 后，覆盖率将基于原始 .ts/.js 文件计算，工具生成的辅助代码（不在你的源码里）就不会出现在报告中了。
