Express+Node.js API的i18n实践：后端还是前端处理响应翻译？

针对你用Express/Node.js写API、前端支持英意双语的场景，两种方案各有适用场景，具体选择看你的业务需求：

后端处理翻译的适用场景与实现 #

• 当API需要对接多端（比如网页、原生APP、第三方服务）时，后端统一翻译能保证所有端的文案一致性，避免各端翻译口径不一的问题。
• 响应中包含动态业务文本（比如「您的订单{{orderId}}已完成」「账户余额不足{{amount}}欧元」）时，后端结合业务数据完成翻译更高效，前端无需再拼接参数和文案。
• 有合规或品牌要求所有对外文案统一管控时，后端集中维护翻译资源更方便。

Express里的实现示例：

// 安装i18n包：npm install i18n
const i18n = require('i18n');
const express = require('express');
const app = express();

// 配置i18n
i18n.configure({
  locales: ['en', 'it'],
  defaultLocale: 'en',
  directory: __dirname + '/locales' // 存放翻译文件的目录，比如locales/en.json、locales/it.json
});

app.use(i18n.init);

// 接口示例
app.get('/api/order/status', (req, res) => {
  const orderId = 'ORD12345';
  // 根据请求头Accept-Language自动选择语言，返回翻译后的文本
  res.json({
    message: req.__('order_completed', { orderId: orderId })
    // 对应en.json: {"order_completed": "Your order {{orderId}} has been completed"}
    // 对应it.json: {"order_completed": "Il tuo ordine {{orderId}} è stato completato"}
  });
});

前端处理翻译的适用场景与优势 #

• 当API仅服务于自己的单一前端项目时，前端处理静态文案更灵活：比如用户切换语言时，前端可以直接切换本地文案，无需重新请求后端。
• 静态UI文案（比如按钮文本「提交」「取消」、页面标题）和UI绑定紧密，前端用专门的i18n库（如react-i18next、vue-i18n）管理更方便，后端无需关心UI相关的文案。
• 后端可以专注于业务逻辑，不用维护多语言文案资源，减少后端复杂度。

混合方案：大多数场景的最佳实践 #

实际项目中更推荐混合模式，分工更清晰：

• 前端负责静态UI文案：比如导航栏、按钮、通用提示语，用前端i18n库管理，切换语言时即时生效。
• 后端负责动态业务文案：比如包含业务数据的提示、状态通知、用户专属消息，后端根据请求的语言标识（通过Accept-Language头或URL参数传递）返回翻译后的文本。
• 前后端约定统一的语言代码（比如en对应英语，it对应意大利语），保证语言标识一致。

总结建议 #

• 如果你的API是对内服务（仅对接自己的前端）：优先采用混合方案，前端管静态，后端管动态，兼顾灵活性和业务准确性。
• 如果API是对外提供的公共接口：后端统一处理翻译，确保所有调用方拿到的文案一致，便于管控。

内容的提问来源于stack exchange，提问作者Allennick