国际化 (i18n)

多语言支持配置和翻译管理

概览

项目使用 next-intl 实现国际化，目前支持中文 (zh) 和英文 (en)。

翻译文件位于 packages/lib-shared/src/i18n/translations/：

translations/
├── en.json    # 英文翻译
└── zh.json    # 中文翻译（默认语言）

翻译文件使用扁平化的 JSON 格式，按模块分组：

{
  "common.save": "保存",
  "common.cancel": "取消",
  "auth.login": "登录",
  "auth.register": "注册",
  "events.create": "创建活动"
}

{
  "myModule.newFeature": "新功能"
}

{
  "myModule.newFeature": "New Feature"
}

import { useTranslations } from "next-intl";

function MyComponent() {
  const t = useTranslations("myModule");
  return <p>{t("newFeature")}</p>;
}

文档和博客使用文件名后缀区分语言：

content/docs/
├── page.zh.mdx    # 中文版本
└── page.en.mdx    # 英文版本

Fumadocs 会根据用户语言自动选择对应版本。

使用 i18n-check 验证翻译完整性：

pnpm exec i18n-check \
  --locales packages/lib-shared/src/i18n/translations \
  --source en \
  --format i18next

该工具可以检测：

i18n: {
  locales: ["zh", "en", "ja"],
}