pnpm下Jest transformIgnorePatterns无法转译vee-validate问题

pnpm 采用软链接+内容寻址存储的依赖结构，依赖实际存放路径为node_modules/.pnpm/[包名@版本]/node_modules/[包名]格式。此前配置的transformIgnorePatterns正则仅匹配项目根node_modules下直接挂载的vee-validate路径，未覆盖pnpm的实际存储路径，导致vee-validate输出的ES模块文件始终在Jest转译忽略列表中，Babel不会处理其export语法，最终抛出语法错误。

所有配置仅影响测试环境转译逻辑，完全不干扰生产构建的tree-shaking效果，无需引入UMD构建产物。

• 修改jest.config.js配置，调整transformIgnorePatterns正则兼容pnpm路径结构，同时补充文件转译规则覆盖mjs/js格式：

// jest.config.js 对应配置项
module.exports = {
  // 保留原有其他配置
  transformIgnorePatterns: [
    'node_modules/(?!(.*vee-validate/dist/rules|.*vee-validate/dist/rules.js))'
  ],
  transform: {
    '^.+\\.(js|mjs|ts|vue)$': 'babel-jest'
  },
  // 如使用@nuxt/test-utils，补充路径映射
  moduleNameMapper: {
    '^@/(.*)$': '<rootDir>/$1',
    '^~/(.*)$': '<rootDir>/$1'
  }
}

• 确认项目根目录存在babel.config.js（不要使用.babelrc，babel-jest处理node_modules下文件时仅会读取根目录的babel.config.js），配置测试环境的Babel转译规则：

// babel.config.js
module.exports = {
  env: {
    test: {
      presets: [
        ['@babel/preset-env', {
          targets: { node: 'current' },
          modules: 'commonjs'
        }]
      ]
    }
  }
}

该Babel配置仅在NODE_ENV=test时生效，生产构建走Nuxt原生构建链路时会保留ES模块语法，tree-shaking逻辑完全不受影响。

配置完成后先清空Jest缓存再执行测试命令，避免旧缓存干扰：

npx jest --clearCache
pnpm test

执行后原SyntaxError: Unexpected token 'export'报错会消失，业务代码可正常从vee-validate/dist/rules按需导入校验规则，生产构建时未使用的规则代码会被自动剔除，无额外体积损耗。

内容的提问来源于stack exchange，提问作者Théo Lavaux