国际化与本地化支持

Express框架作为Node.js生态中最受欢迎的Web框架之一，其灵活性和可扩展性使其成为构建国际化（i18n）和本地化（l10n）应用的理想选择。国际化与本地化支持不仅涉及多语言文本的切换，还包括日期、时间、货币等区域化格式的处理。以下从配置、中间件、动态加载等方面展开具体实现方案。

基础配置与多语言文件结构

实现国际化的第一步是规划多语言文件的结构。通常采用JSON文件按语言分类存储，例如：

// locales/en.json
{
  "welcome": "Welcome",
  "userProfile": "User Profile"
}

// locales/zh-CN.json
{
  "welcome": "欢迎",
  "userProfile": "用户资料"
}

推荐使用i18next这类专业库进行扩展。安装基础依赖：

npm install i18next express-i18next

在Express中初始化配置：

const i18next = require('i18next');
const Backend = require('i18next-fs-backend');
const middleware = require('express-i18next').middleware;

i18next
  .use(Backend)
  .init({
    lng: 'en',
    fallbackLng: 'en',
    backend: {
      loadPath: path.join(__dirname, 'locales/{{lng}}.json')
    }
  });

app.use(middleware.handle(i18next));

动态语言切换中间件

通过请求头或URL参数实现语言动态切换是常见需求。创建自定义中间件处理语言标识：

app.use((req, res, next) => {
  const supportedLangs = ['en', 'zh-CN', 'ja'];
  const lang = req.query.lang || req.acceptsLanguages(supportedLangs) || 'en';
  
  if (supportedLangs.includes(lang)) {
    req.setLocale(lang);
  }
  next();
});

路由层可通过req.i18n.t方法获取翻译文本：

app.get('/greet', (req, res) => {
  res.send(req.t('welcome'));
});

区域敏感的日期与数字格式化

本地化的核心在于区域差异处理。使用Intl对象实现区域化格式：

app.get('/profile', (req, res) => {
  const date = new Date();
  const formatter = new Intl.DateTimeFormat(req.language, {
    year: 'numeric',
    month: 'long'
  });
  
  res.json({
    joinDate: formatter.format(date),
    balance: new Intl.NumberFormat(req.language, {
      style: 'currency',
      currency: 'USD'
    }).format(1000)
  });
});

模板引擎集成

在视图层（如EJS/Pug）中直接使用翻译功能：

<!-- EJS示例 -->
<h1><%= t('userProfile') %></h1>
<p><%= new Intl.DateTimeFormat(language).format(new Date()) %></p>

需在渲染时传入语言上下文：

app.get('/view', (req, res) => {
  res.render('template', {
    t: req.t.bind(req),
    language: req.language
  });
});

客户端与服务端协同方案

对于SPA应用，可通过API返回语言包实现前后端分离方案：

app.get('/locales/:lng', (req, res) => {
  const lng = req.params.lng;
  res.json({
    translations: require(`./locales/${lng}.json`)
  });
});

客户端使用示例（React场景）：

function App() {
  const [t, setT] = useState({});
  
  useEffect(() => {
    fetch(`/locales/${navigator.language}`)
      .then(res => res.json())
      .then(setT);
  }, []);

  return <h1>{t.welcome || 'Loading...'}</h1>;
}

高级场景：按需加载语言包

为优化性能，可采用动态导入实现语言包懒加载：

router.get('/news', async (req, res) => {
  const messages = await import(`../locales/${req.language}/news.json`);
  res.render('news', { messages });
});

错误处理与回退机制

必须实现健壮的错误处理逻辑：

app.use((err, req, res, next) => {
  if (err.code === 'MODULE_NOT_FOUND') {
    const fallback = require('../locales/en/news.json');
    res.status(200).render('news', { messages: fallback });
  } else {
    next(err);
  }
});

自动化测试策略

使用SuperTest进行语言切换测试：

const request = require('supertest');
describe('i18n', () => {
  it('should respond in French', async () => {
    await request(app)
      .get('/?lang=fr')
      .expect(/Bienvenue/);
  });
});

性能优化实践

通过内存缓存提升多语言文件读取速度：

const localeCache = new Map();

function getTranslations(lang) {
  if (localeCache.has(lang)) {
    return localeCache.get(lang);
  }
  const data = require(`./locales/${lang}.json`);
  localeCache.set(lang, data);
  return data;
}

多时区支持方案

针对全球化应用，需单独处理时区问题：

app.use((req, res, next) => {
  req.userTimeZone = req.headers['x-timezone'] || 'UTC';
  next();
});

app.get('/events', (req, res) => {
  const eventDate = new Date('2023-12-25T00:00:00');
  const options = {
    timeZone: req.userTimeZone,
    hour12: false
  };
  res.send(
    new Intl.DateTimeFormat(req.language, options).format(eventDate)
  );
});