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

快速上手

不到 5 分钟,快速上手 CLI。

准备事项

请先确认你已安装 Node.js 18.0 或更高版本。运行 node --version 检查即可。

安装#

使用你常用的包管理器全局安装 CLI:

bash
npm install -g lingo.dev

验证安装#

确认 CLI 已正确安装:

bash
lingo --version

你应该会看到类似这样的输出:

plaintext
lingo.dev v0.133.9
Node.js v20.10.0

初始化项目#

进入项目目录并运行:

bash
cd my-project
lingo init

这个交互式命令会帮助你:

  1. 连接到账户 - 使用 API 密钥完成身份验证
  2. 选择项目 - 选择现有项目或创建新项目
  3. 配置语言 - 选择需要支持的语言
  4. 设置文件结构 - 选择翻译文件的存放位置

配置已创建

CLI 会创建一个 i18n.json 文件来保存你的配置。后续你也可以按需修改。

第一次翻译#

创建一个简单的翻译文件:

json
{
  "welcome": {
    "title": "Welcome to Lingo.dev",
    "subtitle": "The Localization Engineering Platform"
  },
  "auth": {
    "login": "Log in",
    "logout": "Log out"
  }
}

运行翻译#

将内容翻译到所有已配置的目标语言:

bash
lingo run

CLI 会自动:

  • ✅ 识别源文件
  • ✅ 计算与 lockfile 的差异
  • ✅ 将变更内容发送到你的翻译后端
  • ✅ 将翻译结果写入磁盘

监视模式(开发)#

在日常开发中,你可以开启监视模式,在源文件变更时自动重新翻译:

bash
lingo run --watch

按下 Ctrl+C 退出监视模式。

获取帮助#

需要帮助?

bash
# Show help for all commands
lingo --help

# Show help for a specific command
lingo run --help

加入我们的 Discord community,获取实时支持!

下一步#

用 AI 提取键
AI 辅助的 i18n 配置
翻译键
锁定、忽略和重命名键
支持的语言区域
100 多种语言及其变体
支持的格式
JSON、YAML、Markdown 等

这个页面对你有帮助吗?

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