|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 文档

大型项目

Lingo.dev CLI 通过并行处理、借助 lockfile 实现增量翻译,以及定向处理选项,能够轻松适配包含数千个翻译键和数十种目标语言的项目。

并行处理#

CLI 会将翻译任务分配给多个并发 worker。默认并发数为 10:

bash
npx lingo.dev@latest run

对于大型项目,你可以进一步提高并发数:

bash
npx lingo.dev@latest run --concurrency 20

以一个包含 50 个文件、10 种语言的项目为例,总计会产生 500 个翻译任务。通过并行处理,这些任务会同时执行,而不是按顺序依次处理。关于 worker 架构的更多细节,请参阅 Parallel Processing。

定向处理#

无需处理整个项目,只处理指定的内容子集:

bash
# Specific languages
npx lingo.dev@latest run --target-locale es --target-locale fr

# Specific file format
npx lingo.dev@latest run --bucket json

# Specific files
npx lingo.dev@latest run --file components/header

# Specific keys
npx lingo.dev@latest run --key welcome.title

这些选项可以组合使用——--force --bucket json --target-locale es 会仅为西班牙语重新翻译全部 JSON 内容。

CI/CD 集成#

通过 GitHub Actions,在每次 push 时自动执行翻译:

yaml
name: Lingo.dev Localization
on:
  workflow_dispatch:
permissions:
  contents: write
  pull-requests: write
jobs:
  localize:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

lockfile 可确保只翻译发生变更的内容,因此即使面对大型项目,也能让 CI 保持高效快速。

Bucket 组织#

将不同类型的内容拆分到独立的 bucket 中,便于按需处理:

json
{
  "buckets": {
    "json": {
      "include": ["src/locales/[locale].json"]
    },
    "markdown": {
      "include": ["docs/[locale]/*.md"]
    }
  }
}

这样一来,你就可以将文档和应用内容分开处理:--bucket markdown 只会翻译文档。

下一步#

并行处理
了解 worker 架构与并发控制
i18n.lock
了解增量翻译如何工作
支持的格式
所有 bucket 类型及其配置方式
连接你的引擎
通过你的本地化引擎处理翻译

这个页面对你有帮助吗?

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