Next.js集成i18next-parser遇import模块外语法错误求助

数据老陈

2026-8-6

解决i18next-parser在Next.js中运行gulpfile的语法错误问题

错误原因

报错SyntaxError: Cannot use import statement outside a module的核心原因是：Node.js执行gulp脚本时，默认将gulpfile.js识别为CommonJS模块，不支持ES模块的import语法。你尝试的Next.js动态导入是用于React组件的SSR兼容方案，不适用于gulp这类构建脚本，因此无效。

解决方案

方案1：改用CommonJS语法（推荐，无需额外配置）

直接将gulpfile的ES模块语法替换为CommonJS格式：

const gulp = require('gulp');
const { gulp: i18nextParser } = require('i18next-parser');

exports.i18next = async function() {
  return gulp
    .src('./**')
    .pipe(
      new i18nextParser({
        locales: ['en', 'nl'],
        output: './i18n/locales/$LOCALE/$NAMESPACE.json',
      })
    )
    .pipe(gulp.dest('./'));
}

方案2：配置Node.js识别ES模块

如果坚持使用ES模块语法，可通过以下两种方式实现：

方式一：重命名gulpfile
将gulpfile.js改名为gulpfile.mjs，Node.js会自动将后缀为.mjs的文件视为ES模块。
方式二：修改package.json
在项目根目录的package.json中添加"type": "module"配置，这样所有.js文件都会被识别为ES模块：
```
{
  "type": "module"
}
```
注意：此配置会影响项目中所有JS文件的模块解析规则，如果项目存在其他CommonJS格式的代码，需要同步调整为ES模块语法。