|Labs
预约演示平台
React(Lingo Compiler)
Alpha
React (MCP)React(i18n)旧版 CLI(v0)
已废弃

Lingo.dev CLI

  • 工作原理
  • 快速开始
  • 快速上手
  • Monorepos

配置

  • 支持的格式
  • i18n.json
  • i18n.lock
  • 支持的语言区域

功能特性

  • 现有翻译
  • 添加语言
  • 覆盖
  • 翻译注释
  • 翻译键
  • 键重命名
  • 键锁定
  • 键忽略
  • 键保留
  • 借助 AI 提取键

性能

  • 大型项目
  • 并行处理
  • 成本预估

重新翻译

  • 自动重新翻译
  • 重新翻译
  • 删除翻译

此处文档涵盖的是旧版 CLI(v0),现已废弃。当前版本的 CLI 为 v1。 查看当前 CLI 文档

添加语言

只需更新 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 就会停止处理它。现有文件不会自动删除,如有需要请手动移除。

下一步#

现有翻译
集成到已经有翻译内容的项目中
并行处理
并发处理多种语言
大型项目
本地化规模扩展策略
i18n.json
完整配置参考

这个页面对你有帮助吗?

Max PrilutskiyMax Prilutskiy·已更新 4 天前·1 分钟阅读