统一收集多端代码覆盖率需“统一插桩、分离上报、集中归并”：Web用babel-plugin-istanbul，RN用Canyon+swc-coverage，小程序构建前用istanbul-lib-instrument插桩，Electron主进程用nyc、渲染进程同Web；各端输出标准lcov格式至coverage/{platform}.lcov，用lcov合并并过滤node_modules等，推荐Canyon实现按端标签聚合与新增代码覆盖分析；须规避RN入口绕过插桩、小程序独立文件漏插、Electron HMR导致新代码未插桩及sourceMap指向错误等问题。
多端项目（如 Web + React Native + 小程序或 Electron）统一收集代码覆盖率，核心在于“统一插桩、分离上报、集中归并”。不能依赖单个工具链，而要让所有端共享同一套覆盖率采集逻辑，并将原始数据按规范汇入统一处理流程。
确保所有端使用兼容的插桩方案
不同运行环境对代码注入方式支持不同，需选择跨平台兼容的插桩器：
-
Web 端（含 Playwright/Cypress）：用
babel-plugin-istanbul或vite-plugin-istanbul，配置include: ['src/**/*.{js,ts,jsx,tsx}']，关闭excludeNodeModules避免误删路径 -
React Native：Canyon 明确支持 RN 场景，通过
metro.config.js注入swc-coverage-instrument或 Babel 插件，关键是要开启sourceMap并确保outDir不改变源码相对路径 -
小程序（微信/支付宝）：需在构建前对源码插桩，推荐用
istanbul-lib-instrument手动处理src/目录，再交由小程序编译器处理；避免在 minify 后插桩，否则行号错乱 -
Electron 主进程/渲染进程：主进程用
nyc包裹启动脚本（nyc electron .），渲染进程同 Web 端，共用 Babel 插桩配置
标准化覆盖率数据输出格式与路径
各端必须输出 lcov 格式且路径结构一致，否则合并时会因文件名或路径前缀不匹配导致丢数据：
- 统一设置
coverageDirectory: 'coverage'，禁止子项目自定义为dist/coverage或build/coverage - 每端测试完成后，生成
coverage/lcov.info，但立即重命名为带端标识的文件：coverage/web.lcov、coverage/rn.lcov、coverage/miniprogram.lcov - 使用
lcov --base-directory统一源码根路径（如../src），解决跨端路径差异问题
用 lcov 合并 + Canyon 增强聚合能力
基础合并可用 lcov CLI，但多端场景下建议引入 Canyon 提升可靠性：
立即学习“Java免费学习笔记（深入）”；
- 先用
lcov --directory coverage --output-file coverage/merged.lcov合并所有.lcov文件 - 再用
lcov --remove coverage/merged.lcov 'node_modules/*' '**/*.test.*' '**/mocks/**' --output-file coverage/final.lcov过滤无关内容 - Canyon 可替代传统
genhtml：它支持按端维度打标签（platform: web）、实时聚合多批次上报（适合 E2E 分批次执行）、自动关联 Git 变更范围，生成带「新增代码覆盖率」的报告 - 若使用 Canyon，各端只需调用其 SDK 上报原始
__coverage__对象，服务端自动完成归一化与合并
规避多端常见失真点
以下细节不注意，会导致总覆盖率虚高或漏统计：
- React Native 的
index.js入口和 Metro 的resolveRequest逻辑可能绕过插桩，需在metro.config.js中显式 include - 小程序的
app.js和页面xxx.js是独立加载的，要确保每个文件都被单独插桩，不能只插桩src/下的模块 - Electron 渲染进程若用 Vite/HMR，热更新后新代码未被插桩，需禁用 HMR 或在 dev 模式下跳过覆盖率收集
- 所有端的
sourceMap必须指向原始 TS/JS 源码，而非构建后产物，否则 HTML 报告无法准确定位行
