You need to enable JavaScript to run this app. 原生JS子模块在Jest报Cannot use import statement outside a module错误如何修复
优惠活动
大模型
产品
解决方案
定价
更多

原生JS子模块在Jest报Cannot use import statement outside a module错误如何修复

错误根因

该报错由Jest的ESM处理逻辑与你的项目配置不匹配导致,核心问题有三个:

  1. Jest 默认采用CommonJS运行环境,原生ESM支持需要手动开启,未转译的import语句会直接抛出语法错误
  2. 你的.helpers子模块目录没有被纳入转译/ESM识别范围,子模块内的ESM语法无法被Jest正常解析
  3. 你保留的.babelrc存在test环境配置,Jest运行时会自动读取该配置尝试转译代码,但转译范围没有覆盖.helpers目录,反而导致转译不完整触发报错

修复方案

方案一:开启Jest原生ESM支持(推荐,适配纯原生ESM项目)

无需依赖Babel转译,直接开启Jest的原生ESM支持即可:

  1. 修改Translator/package.json中的test脚本,添加Node ESM支持flag:
{
  "scripts": {
    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage --coverageDirectory=coverage",
    // 其余脚本保持不变
  }
}
  1. 在Jest配置块中新增ESM识别配置:
{
  "jest": {
    "type": "module",
    "extensionsToTreatAsEsm": [".js"],
    "setupFiles": [
      "<rootDir>/.jest/init.js",
      "<rootDir>/.jest/console.js"
    ],
    "collectCoverageFrom": [
      "Translator/**/*test.js"
    ],
    "testPathIgnorePatterns": [
      "<rootDir>/.helpers/"
    ],
    // 其余原有配置保持不变
  }
}
  1. 调整Babel配置避免干扰:将.babelrc重命名为.babelrc.eslint,然后在ESlint配置文件中添加parserOptions: { babelOptions: { configFile: "./.babelrc.eslint" } },避免Jest运行时读取该Babel配置产生转译冲突。

方案二:调整Babel转译范围(兼容旧版Jest)

如果不想使用实验性的原生ESM特性,可调整Babel转译配置覆盖子模块目录:

  1. 修改Jest配置,添加转译规则覆盖.helpers目录:
{
  "jest": {
    "transformIgnorePatterns": [
      "node_modules/(?!\\.helpers)"
    ],
    // 其余原有配置保持不变
  }
}
  1. 修改.babelrc配置,添加include规则覆盖子模块:
{
  "include": [
    "./Translator/**/*",
    "./.helpers/**/*"
  ],
  "presets": [
    ["@babel/preset-env",
    {
      "shippedProposals": true
    }]
  ],
  "env": {
    "test": {
      "plugins": ["@babel/plugin-transform-runtime"]
    }
  }
}

修改完成后重新运行测试命令即可正常执行。


内容的提问来源于stack exchange,提问作者Eduardo Russo

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 12:00:05