添加语言 · Lingo.dev

只需更新 targets 中的 i18n.json 数组并运行 CLI，即可添加新的目标语言。CLI 会为新的 locale 生成完整的翻译文件，现有翻译则保持不变。

添加语言#

更新你的 i18n.json 配置：

json

{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  }
}

运行 CLI：

bash

npx lingo.dev@latest run

CLI 会为每个新的 locale 创建完整的翻译文件：

text

locales/
  en.json    (source - unchanged)
  es.json    (existing - unchanged)
  fr.json    (existing - unchanged)
  de.json    (new - fully translated)

现有语言 vs. 新语言#

CLI 对现有语言和新语言的处理方式有所不同：

	现有语言	新语言
处理方式	只翻译缺失的键	从头生成完整文件
现有内容	保留	不适用

区域变体#

CLI 支持通过 BCP 47 标签指定区域语言变体：

json

{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-ES", "es-MX", "fr-FR", "fr-CA", "pt-BR", "pt-PT"]
  }
}

每种变体都会生成独立的翻译文件，并采用符合对应地区的术语、拼写和语气。

按需生成#

只为某一种语言生成翻译，无需处理所有 targets：

bash

npx lingo.dev@latest run --target-locale de

如果你想一次只添加一种语言，并在继续扩展前先检查翻译质量，这种方式会特别方便。

移除语言#

将某个 locale 从 targets 数组中移除后，CLI 就会停止处理它。现有文件不会自动删除，如有需要请手动移除。

下一步#