Vite覆盖率失真因编译产物与源码映射偏差，需通过启用inline source map、禁用esbuild压缩、统一转译目标、使用c8替代istanbul来解决。
Vite 编译产物（如 esbuild 压缩、ESM 拆包、source map 映射不全）会导致 Istanbul 或 c8 等覆盖率工具统计失真——实际运行的是编译后代码，但覆盖率却映射到源码，中间存在行号偏移、语句合并、死码消除等问题。核心解法是确保测试运行环境与覆盖率采集环节能准确将执行位置回溯到原始源码。
用 source map 精确映射执行位置
Vite 默认生成 source map（build.sourcemap: true），但测试时需确保覆盖率工具能读取并正确使用它：
- c8 默认支持 inline source map，推荐在 Vite 测试配置中启用：
vite.config.ts中设build.sourcemap: 'inline'（避免外部 .map 文件路径问题） - 若用 Jest + ts-jest，需在
jest.config.js中显式配置transformSource: true并确保ts-jest版本 ≥29.1，同时禁用isolatedModules: true（否则会跳过装饰器/enum 等语法的 source map 生成） - 验证是否生效：在测试中故意抛错，检查堆栈是否指向
.ts文件而非.js或.mjs
避免 esbuild 压缩干扰覆盖率插桩
esbuild 的 minify 和 tree-shaking 会删减未调用分支、合并变量声明，导致插桩语句丢失或行号错位：
- 测试阶段禁用压缩：在 Vite 配置中为 test 环境设置
build.minify: false和build.terserOptions: undefined - 关闭自动 treeshaking：添加
build.rollupOptions.treeshake: false（仅限测试构建，不影响生产） - 若用 vitest，直接在
vitest.config.ts中配置esbuild: { minify: false, target: 'es2020' }，避免默认 target 过高导致语法转换偏差
统一构建与测试的转译目标
Vite 开发服务器和测试环境可能使用不同转译策略（如开发用 esbuild，测试用 babel），造成 AST 结构不一致，影响插桩准确性：
立即学习“Java免费学习笔记（深入）”；
- 强制 Vitest 使用与 Vite 构建一致的转译器：在
vitest.config.ts中设transformMode: { web: [/\.[jt]sx?$/]，并禁用test.environment: 'node'下的额外 babel 处理 - 若项目含 JSX/TSX，确保
jsx: 'preserve'且不启用react-jsx自动转换，防止 jsx 插入干扰行号 - 检查
tsconfig.json中compilerOptions.sourceMap和inlineSources均为true，保证 TS 层 source map 完整
用 c8 替代 istanbul-instrumenter-loader（已废弃）
旧方案依赖 Webpack loader 在构建时插桩，而 Vite 无 loader 生态，强行接入易出错；c8 基于 V8 引擎原生 code coverage，绕过静态插桩，更适配 ESM 动态加载：
- 安装：
npm add -D c8，然后用npx c8 --reporter=html --reporter=text vitest run启动 - c8 自动识别
import.meta.url和动态import()，对 Vite 的 HMR 和按需加载兼容性更好 - 若需忽略类型文件或测试辅助代码，在
c8.config.js中用exclude: ['**/*.d.ts', '**/test-utils/**']
