Lingui项目与Turbopack的兼容性解决方案

在Next.js项目中使用Lingui国际化工具时，随着项目规模扩大，编译时间会显著增加。Turbopack作为Next.js的新一代打包工具，可以大幅提升编译速度，但在与Lingui的loader配合使用时存在兼容性问题。

问题背景

Lingui的loader原本是为Webpack环境设计的，它通过检查this._module.type来判断输出格式是JSON还是ES模块。然而在Turbopack环境下，这个变量不存在，导致直接使用会报错。

解决方案

通过简单的条件判断即可解决兼容性问题：

namespace: '_module' in this ? this._module.type === "json" ? "json" : "es" : 'es'

这个修改保留了Webpack的兼容性，同时在非Webpack环境下默认使用ES模块格式。

Next.js配置示例

在Next.js项目中启用Turbopack并配置Lingui支持，需要在next.config.js中进行如下配置：

module.exports = {
  experimental: {
    swcPlugins: [["@lingui/swc-plugin", {}]],
    turbo: {
      resolveExtensions: [".mdx", ".tsx", ".ts", ".jsx", ".js", ".mjs", ".json", ".po"],
      rules: {
        "*.po": ["@lingui/loader"],
      },
    },
  }
};

使用方式变化

启用Turbopack后，导入.po文件的方式变得更简洁：

async function loadLinguiMessages(lang) {
  return (await import(`src/locales/${lang}/messages.po`)).messages;
}

不再需要@lingui/loader!前缀。

后续发展

Lingui团队在后续版本中进一步完善了对Turbopack的支持，特别是在4.1.0版本的swc-plugin中解决了Next.js 15的兼容性问题。开发者现在可以更顺畅地在Turbopack环境中使用Lingui进行国际化开发。

注意事项

虽然大部分功能可以正常工作，但在某些情况下，如使用t和plural宏时可能会遇到i18n未定义的问题。这时可以显式传入i18n实例作为临时解决方案：

t(i18n)`Message`

Lingui团队正在持续优化对Turbopack的支持，建议开发者关注最新版本的更新。