升级Vue3后babel-jest代码覆盖率异常与重复插件报错问题

算力阿峰

2026-10-4

问题排查路径

核心诱因是环境变量触发的双配置加载：Vue3 + Jest 生态默认会在NODE_ENV=test时自动注入babel-plugin-istanbul用于覆盖率采集，若你的.babelrc.js中又手动配置了该插件的 test 环境专属规则，双重加载就会抛出重复插件错误。
直接运行node scripts/test.js时未设置NODE_ENV=test，两个覆盖率采集触发条件都不生效：一是手动配置的 istanbul 插件未激活，二是 Jest 默认的覆盖率注入逻辑也没有触发，最终采集到的覆盖率自然为 0。
提示script.js第3行未覆盖属于覆盖率采集工具未正常插桩时的默认误报，和实际代码覆盖情况无关。

解决方案

清理.babelrc.js的重复插件配置，给手动声明的babel-plugin-istanbul加加载判断，避免和 Jest 自动注入的插件冲突：

// .babelrc.js 调整示例
module.exports = {
  presets: [/* 保留原有preset配置 */],
  plugins: [
    // 保留原有其他插件配置
    ...(process.env.NODE_ENV === 'test' && !process.env.JEST_WORKER_ID
      ? [require('babel-plugin-istanbul')]
      : [])
  ]
}

统一测试启动脚本的环境变量，不需要手动传参声明，直接在scripts/test.js最开头加环境变量赋值：

// scripts/test.js 开头新增
process.env.NODE_ENV = 'test'
// 后续保留原有测试启动逻辑

调整 Jest 配置的覆盖率规则，排除不需要统计的工具类脚本：

// jest.config.js 调整示例
module.exports = {
  // 保留原有其他配置
  collectCoverage: true,
  coverageProvider: 'babel',
  coveragePathIgnorePatterns: [
    '/node_modules/',
    '/scripts/' // 把测试启动脚本所在目录排除出覆盖率统计范围
  ]
}