只需更新 targets 中的 i18n.json 数组并运行 CLI,即可添加新的目标语言。CLI 会为新的 locale 生成完整的翻译文件,现有翻译则保持不变。
添加语言#
更新你的 i18n.json 配置:
json
{
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
}
}运行 CLI:
bash
npx lingo.dev@latest runCLI 会为每个新的 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 就会停止处理它。现有文件不会自动删除,如有需要请手动移除。
